From 65f4e36a754d1cb01b2747b4a326edfdf9f57bde Mon Sep 17 00:00:00 2001 From: AI Agent Date: Mon, 16 Feb 2026 13:12:06 +0100 Subject: [PATCH] Add new Polymarket documentation (2026-02-16) --- docs/changelog/changelog.md | 108 ++++++++++++++++++ docs/developers/builders/examples.md | 82 +++++++++++++ .../FAQ/does-polymarket-have-an-api.md | 11 ++ docs/polymarket-learn/FAQ/is-my-money-safe.md | 19 +++ .../FAQ/what-are-prediction-markets.md | 29 +++++ .../deposits/how-to-withdraw.md | 34 ++++++ 6 files changed, 283 insertions(+) create mode 100644 docs/changelog/changelog.md create mode 100644 docs/developers/builders/examples.md create mode 100644 docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md create mode 100644 docs/polymarket-learn/FAQ/is-my-money-safe.md create mode 100644 docs/polymarket-learn/FAQ/what-are-prediction-markets.md create mode 100644 docs/polymarket-learn/deposits/how-to-withdraw.md diff --git a/docs/changelog/changelog.md b/docs/changelog/changelog.md new file mode 100644 index 0000000..bac8a03 --- /dev/null +++ b/docs/changelog/changelog.md @@ -0,0 +1,108 @@ +# Polymarket Changelog + +> Welcome to the Polymarket Changelog. Here you will find any important changes to Polymarket, including but not limited to CLOB, API, UI and Mobile Applications. + + + * **Sports market fees**: Taker fees to be enabled on NCAAB (college basketball) and Serie A markets on February 18, 2026. + * **Per-market rebate calculation**: Rebates are now calculated per market, makers only compete with other makers in the same market. + * **Updated documentation**: [Maker Rebates Program](/polymarket-learn/trading/maker-rebates-program) and [Developer Guide](/developers/market-makers/maker-rebates-program) updated with sports fee tables and parameters. + + + + * **Withdrawal Endpoint**: New `/withdraw` endpoint to bridge USDC.e from Polymarket to any supported chain and token. + * **Multi-chain withdrawals**: Withdraw to EVM chains (Ethereum, Arbitrum, Base, etc.), Solana, and Bitcoin. + * **Updated documentation**: Bridge API docs updated to reflect deposit and withdrawal functionality. + + + + * RTDS docs updated to reflect RTDS supports **comments** and **crypto prices** only. + * Removed legacy CLOB references and `clob_auth` from RTDS docs. + + + + * **Maker Rebates Program**: Updated funding schedule with distribution method (volume-weighted vs fee-curve weighted). + * **Fee-curve weighted rebates**: Documented fee-equivalent formula and rebate calculation. + * **FAQ**: Clarified how rebates are calculated during fee-curve weighted periods. + + + + * **Releases**: Daily Releases timing + * **HeartBeats API**: HeartBeats endpoint for monitoring connection status and canceling orders + * **Post Only Orders**: Orders that are rejected if they would immediately match against an existing order + + + + * **Taker Fees**: Enabled on 15-minute crypto markets. Fees vary by price and peak at 1.56% at 50% probability. + * **Maker Rebates**: Daily USDC rebates paid to liquidity providers, funded by taker fees. + + + + * **Crypto Price Feeds**: Access real-time cryptocurrency prices from two sources (Binance & Chainlink) + * **Comment Streaming**: Real-time updates for comment events including new comments, replies, and reactions + * **Dynamic Subscriptions**: Add, remove, and modify subscriptions without reconnecting + * **TypeScript Client**: Official TypeScript client available at [real-time-data-client](https://github.com/Polymarket/real-time-data-client) + For complete documentation, see [RTDS Overview](/developers/RTDS/RTDS-overview). + + + + * There has been a significant change to the structure of the price change message. This update will be applied at 11PM UTC September 15, 2025. We apologize for the short notice + * Please see the [migration guide](/developers/CLOB/websocket/market-channel-migration-guide) for details. + + + + * Reduced maximum values for query parameters on Data-API /trades and /activity: + * `limit`: 500 + * `offset`: 1,000 + + + + * The batch orders limit has been increased from from 5 -> 15. Read more about the batch orders functionality [here](/developers/CLOB/orders/create-order-batch). + + + + * We're adding new fields to the `get-book` and `get-books` CLOB endpoints to include key market metadata that previously required separate queries. + * `min_order_size` + * type: string + * description: Minimum allowed order size. + * `neg_risk` + * type: boolean + * description: Boolean indicating whether the market is neg\_risk. + * `tick_size` + * type: string + * description: Minimum allowed order size. + + + + * We're excited to roll out a highly requested feature: **order batching**. With this new endpoint, users can now submit up to five trades in a single request. To help you get started, we've included sample code demonstrating how to use it. Please see [Place Multiple Orders (Batching)](/developers/CLOB/orders/create-order-batch) for more details. + + + + * We're adding a new `side` field to the `MakerOrder` portion of the trade object. This field will indicate whether the maker order is a `buy` or `sell`, helping to clarify trade events where the maker side was previously ambiguous. For more details, refer to the MakerOrder object on the [Get Trades](/developers/CLOB/trades/trades) page. + + + + * The 100 token subscription limit has been removed for the Markets channel. You can now subscribe to as many token IDs as needed for your use case. + * New Subscribe Field `initial_dump` + * Optional field to indicate whether you want to receive the initial order book state when subscribing to a token or list of tokens. + * `default: true` + + + + We're excited to introduce a new order type soon to be available to all users: Fill and Kill (FAK). FAK orders behave similarly to the well-known Fill or Kil(FOK) orders, but with a key difference: + + * FAK will fill as many shares as possible immediately at your specified price, and any remaining unfilled portion will be canceled. + * Unlike FOK, which requires the entire order to fill instantly or be canceled, FAK is more flexible and aims to capture partial fills if possible. + + + + All API users will enjoy increased rate limits for the CLOB endpoints. + + * CLOB - /books (website) (300req - 10s / Throttle requests over the maximum configured rate) + * CLOB - /books (50 req - 10s / Throttle requests over the maximum configured rate) + * CLOB - /price (100req - 10s / Throttle requests over the maximum configured rate) + * CLOB markets/0x (50req / 10s - Throttle requests over the maximum configured rate) + * CLOB POST /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rateed + * CLOB POST /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate + * CLOB DELETE /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rate + * DELETE /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate + diff --git a/docs/developers/builders/examples.md b/docs/developers/builders/examples.md new file mode 100644 index 0000000..9e4ef26 --- /dev/null +++ b/docs/developers/builders/examples.md @@ -0,0 +1,82 @@ +# Examples + +> Complete Next.js applications demonstrating Polymarket builder integration + +## Overview + +These open-source demo applications show how to integrate Polymarket's CLOB Client and Builder Relayer Client for gasless trading with builder order attribution. + + + + Multiple wallet providers + + + + Safe & Proxy wallet support + + + + Orders, positions, CTF ops + + + +*** + +## Safe Wallet Examples + +Deploy Gnosis Safe wallets for your users: + + + + MetaMask, Phantom, Rabby, and other browser wallets + + + + Privy embedded wallets + + + + Magic Link email/social authentication + + + + Turnkey embedded wallets + + + +## Proxy Wallet Examples + +For existing Magic Link users from Polymarket.com: + + + + Auto-deploying proxy wallets for Polymarket.com Magic users + + + +*** + +## What Each Demo Covers + + + + * User sign-in via wallet provider + * User API credential derivation (L2 auth) + * Builder config with remote signing + * Signature types for Safe vs Proxy wallets + + + + * Safe wallet deployment via Relayer + * Batch token approvals (USDC.e + outcome tokens) + * CTF operations (split, merge, redeem) + * Transaction monitoring + + + + * CLOB client initialization + * Order placement with builder attribution + * Position and order management + * Market discovery via Gamma API + + diff --git a/docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md b/docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md new file mode 100644 index 0000000..51b4265 --- /dev/null +++ b/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. + + + If you have any questions please join our [Discord](https://discord.com/invite/polymarket) and direct your questions to the #devs channel. + diff --git a/docs/polymarket-learn/FAQ/is-my-money-safe.md b/docs/polymarket-learn/FAQ/is-my-money-safe.md new file mode 100644 index 0000000..eb885de --- /dev/null +++ b/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. diff --git a/docs/polymarket-learn/FAQ/what-are-prediction-markets.md b/docs/polymarket-learn/FAQ/what-are-prediction-markets.md new file mode 100644 index 0000000..2109dc9 --- /dev/null +++ b/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. diff --git a/docs/polymarket-learn/deposits/how-to-withdraw.md b/docs/polymarket-learn/deposits/how-to-withdraw.md new file mode 100644 index 0000000..2bcce9b --- /dev/null +++ b/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. + + + + Go to the Polymarket funds page and click on the **Withdraw** button. + + + + 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. + + + + Click **Withdraw**. Your funds will be transferred instantly. + + + +