Add new Polymarket documentation (2026-02-16)

docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md

@@ -0,0 +1,11 @@
+# Does Polymarket have an API?
+
+> Getting data from Polymarket
+
+Yes! Developers can find all the information they need for interacting with Polymarket. This includes [documentation on market discovery, resolution, trading etc.](/quickstart/overview)
+
+Whether you are an academic researcher a market maker or an indepedent developer, this documentation should provide you what you need to get started. All the code you find linked here and on our [GitHub](https://github.com/polymarket) is open source and free to use.
+
+<Tip>
+  If you have any questions please join our [Discord](https://discord.com/invite/polymarket) and direct your questions to the #devs channel.
+</Tip>

docs/polymarket-learn/FAQ/is-my-money-safe.md

@@ -0,0 +1,19 @@
+# Is My Money Safe?
+
+> Yes. Polymarket is non-custodial, so you're in control of your funds.
+
+#### Non-custodial, you're in control
+
+Polymarket recognizes the importance of a trustworthy environment for managing your funds. To ensure this, Polymarket uses non-custodial wallets, meaning we never take possession of your USDC. This approach gives you full control over your assets, providing protection against potential security threats like hacks, misuse, and unauthorized transactions.
+
+### Your keys = your funds
+
+A private key acts like a highly secure password, essential for managing and moving your assets without restrictions. You can export your private key at any time, ensuring sole access to your funds. Learn how to export your private key [here](../FAQ/how-to-export-private-key/).
+
+### Keep your private keys private.
+
+**Do not share your private key with others**. While Polymarket provides the infrastructure, the security of your assets depends on how securely you handle your private key and passwords. Losing your private key or passwords can result in losing access to your funds. It's crucial to store this information in a safe and secure environment.
+
+### Our Commitment
+
+Polymarket aims to give you peace of mind, knowing that your assets are safe and fully under your control at all times. We encourage you to take necessary precautions to secure your digital assets effectively. The ability to manage your private key means you are not reliant on Polymarket to secure your assets; you have the control to ensure your financial security.

docs/polymarket-learn/FAQ/what-are-prediction-markets.md

@@ -0,0 +1,29 @@
+# What is a Prediction Market?
+
+> How people collectively forecast the future.
+
+A prediction market is a platform where people can bet on the outcome of future events. By buying and selling shares in the outcomes, participants collectively forecast the likelihood of events such as sports results, political elections, or entertainment awards.
+
+### How it works
+
+Market Prices = Probabilities: The price of shares in a prediction market represents the current probability of an event happening. For example, if shares of an event are trading at 20 cents, it indicates a 20% chance of that event occurring.
+
+### Making predictions
+
+If you believe the actual probability of an event is higher than the market price suggests, you can buy shares. For instance, if you think a team has a better than 20% chance of winning, you would buy shares at 20 cents. If the event occurs, each share becomes worth \$1, yielding a profit.
+
+### Free-market trading
+
+You can buy or sell shares at any time before the event concludes, based on new information or changing circumstances. This flexibility allows the market prices to continuously reflect the most current and accurate probabilities.
+
+### Trust the markets
+
+Prediction markets provide unbiased and accurate probabilities in real time, cutting through the noise of human and media biases. Traditional sources often have their own incentives and slants, but prediction markets operate on the principle of "put your money where your mouth is." Here, participants are financially motivated to provide truthful insights, as their profits depend on the accuracy of their predictions.
+
+In a prediction market, prices reflect the aggregated sentiment of all participants, weighing news, data, expert opinions, and culture to determine the true odds. Unlike media narratives, which can be swayed by various biases, prediction markets offer a transparent view of where people genuinely believe we're heading.
+
+#### Why use prediction markets?
+
+Prediction markets are often more accurate than traditional polls and expert predictions. The collective wisdom of diverse participants, each motivated by the potential for profit, leads to highly reliable forecasts. This makes prediction markets an excellent tool for gauging real-time probabilities of future events.
+
+Polymarket, the world's largest prediction market, offers a user-friendly platform to bet on a wide range of topics, from sports to politics. By participating, you can profit from your knowledge while contributing to the accuracy of market predictions.

docs/polymarket-learn/deposits/how-to-withdraw.md

@@ -0,0 +1,34 @@
+# How to Withdraw
+
+> How to withdraw your cash balance from Polymarket.
+
+Withdrawing from Polymarket is simple, instant, and free.
+
+<Steps>
+  <Steps.Step>
+    Go to the Polymarket funds page and click on the **Withdraw** button.
+  </Steps.Step>
+
+  <Steps.Step>
+    Enter the USDC address you wish to withdraw to. Make sure the address
+    supports USDC on the Polygon network. Then, enter the amount you want to
+    withdraw.
+  </Steps.Step>
+
+  <Steps.Step>
+    Click **Withdraw**. Your funds will be transferred instantly.
+  </Steps.Step>
+</Steps>
+
+<iframe width="560" height="315" src="https://www.youtube.com/embed/fAXn0LCPTgA?si=JsYilGM3h0jSNBZa" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
+
+<Note>
+  Note: When withdrawing USDC.e (bridged USDC) is swapped through the [Uniswap v3 pool](https://polygonscan.com/address/0xd36ec33c8bed5a9f7b6630855f1533455b98a418)
+  for USDC (native) (the UI enforces less than 10bp difference in output
+  amount). At times, this pool may be exhausted and for extremely large deposits
+  there might not be enough liquidity. If you are having withdraw issues, try
+  breaking your withdraw into smaller amounts or waiting for the pool to be
+  rebalanced. Additionally, you can select to withdraw USDC.e directly which
+  does not require any Uniswap liquidity; just be aware that some exchanges no
+  longer allow USDC.e to be deposited directly.
+</Note>