Add new Polymarket documentation (2026-02-16)
This commit is contained in:
AI Agent
@@ -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.
|
||||
|
||||
<Update label="Feb 11, 2026" description="Taker Fees & Maker Rebates: NCAAB and Serie A">
|
||||
* **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.
|
||||
</Update>
|
||||
|
||||
<Update label="Jan 28, 2026" description="Bridge API: Withdrawal Endpoint">
|
||||
* **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.
|
||||
</Update>
|
||||
|
||||
<Update label="Jan 16, 2026" description="Docs Update: RTDS documentation">
|
||||
* RTDS docs updated to reflect RTDS supports **comments** and **crypto prices** only.
|
||||
* Removed legacy CLOB references and `clob_auth` from RTDS docs.
|
||||
</Update>
|
||||
|
||||
<Update label="Jan 16, 2026" description="Docs Update: Maker Rebates Program">
|
||||
* **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.
|
||||
</Update>
|
||||
|
||||
<Update label="Jan 6, 2026" description="New API Features">
|
||||
* **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
|
||||
</Update>
|
||||
|
||||
<Update label="Jan 5, 2026" description="Taker Fees & Maker Rebates">
|
||||
* **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.
|
||||
</Update>
|
||||
|
||||
<Update label="Sept 24, 2025" description="Polymarket Real-Time Data Socket (RTDS) official release">
|
||||
* **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).
|
||||
</Update>
|
||||
|
||||
<Update label="September 15, 2025" description="WSS price_change event update">
|
||||
* 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.
|
||||
</Update>
|
||||
|
||||
<Update label="August 26, 2025" description="Updated /trades and /activity endpoints">
|
||||
* Reduced maximum values for query parameters on Data-API /trades and /activity:
|
||||
* `limit`: 500
|
||||
* `offset`: 1,000
|
||||
</Update>
|
||||
|
||||
<Update label="August 21, 2025" description="Batch Orders Increase">
|
||||
* 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).
|
||||
</Update>
|
||||
|
||||
<Update label="July 23, 2025" description="Get Book(s) update">
|
||||
* 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.
|
||||
</Update>
|
||||
|
||||
<Update label="June 3, 2025" description="New Batch Orders Endpoint">
|
||||
* 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.
|
||||
</Update>
|
||||
|
||||
<Update label="June 3, 2025" description="Change to /data/trades">
|
||||
* 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.
|
||||
</Update>
|
||||
|
||||
<Update label="May 28, 2025" description="Websocket Changes">
|
||||
* 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`
|
||||
</Update>
|
||||
|
||||
<Update label="May 28, 2025" description="New FAK Order Type">
|
||||
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.
|
||||
</Update>
|
||||
|
||||
<Update label="May 15, 2025" description="Increased API Rate Limits">
|
||||
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
|
||||
</Update>
|
||||
@@ -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.
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="Authentication" icon="user-check">
|
||||
Multiple wallet providers
|
||||
</Card>
|
||||
|
||||
<Card title="Gasless Trading" icon="gas-pump">
|
||||
Safe & Proxy wallet support
|
||||
</Card>
|
||||
|
||||
<Card title="Full Integration" icon="puzzle-piece">
|
||||
Orders, positions, CTF ops
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
***
|
||||
|
||||
## Safe Wallet Examples
|
||||
|
||||
Deploy Gnosis Safe wallets for your users:
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="wagmi + Safe" icon="wallet" href="https://github.com/Polymarket/wagmi-safe-builder-example">
|
||||
MetaMask, Phantom, Rabby, and other browser wallets
|
||||
</Card>
|
||||
|
||||
<Card title="Privy + Safe" icon="shield-check" href="https://github.com/Polymarket/privy-safe-builder-example">
|
||||
Privy embedded wallets
|
||||
</Card>
|
||||
|
||||
<Card title="Magic Link + Safe" icon="wand-magic-sparkles" href="https://github.com/Polymarket/magic-safe-builder-example">
|
||||
Magic Link email/social authentication
|
||||
</Card>
|
||||
|
||||
<Card title="Turnkey + Safe" icon="key" href="https://github.com/Polymarket/turnkey-safe-builder-example">
|
||||
Turnkey embedded wallets
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Proxy Wallet Examples
|
||||
|
||||
For existing Magic Link users from Polymarket.com:
|
||||
|
||||
<CardGroup cols={1}>
|
||||
<Card title="Magic Link + Proxy" icon="wand-magic-sparkles" href="https://github.com/Polymarket/magic-proxy-builder-example">
|
||||
Auto-deploying proxy wallets for Polymarket.com Magic users
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
***
|
||||
|
||||
## What Each Demo Covers
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Authentication">
|
||||
* User sign-in via wallet provider
|
||||
* User API credential derivation (L2 auth)
|
||||
* Builder config with remote signing
|
||||
* Signature types for Safe vs Proxy wallets
|
||||
</Tab>
|
||||
|
||||
<Tab title="Wallet Operations">
|
||||
* Safe wallet deployment via Relayer
|
||||
* Batch token approvals (USDC.e + outcome tokens)
|
||||
* CTF operations (split, merge, redeem)
|
||||
* Transaction monitoring
|
||||
</Tab>
|
||||
|
||||
<Tab title="Trading">
|
||||
* CLOB client initialization
|
||||
* Order placement with builder attribution
|
||||
* Position and order management
|
||||
* Market discovery via Gamma API
|
||||
</Tab>
|
||||
</Tabs>
|
||||
@@ -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>
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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>
|
||||
Reference in New Issue
Block a user