diff --git a/TARGET.md b/TARGET.md index 63cb679..85f1df1 100644 --- a/TARGET.md +++ b/TARGET.md @@ -186,3 +186,58 @@ https://docs.polymarket.com/developers/proxy-wallet.md ## Negative Risk https://docs.polymarket.com/developers/neg-risk/overview.md + +## Changelog +https://docs.polymarket.com/changelog/changelog.md + +## Polymarket Learn - FAQ +https://docs.polymarket.com/polymarket-learn/FAQ/does-polymarket-have-an-api.md +https://docs.polymarket.com/polymarket-learn/FAQ/embeds.md +https://docs.polymarket.com/polymarket-learn/FAQ/geoblocking.md +https://docs.polymarket.com/polymarket-learn/FAQ/how-to-export-private-key.md +https://docs.polymarket.com/polymarket-learn/FAQ/is-my-money-safe.md +https://docs.polymarket.com/polymarket-learn/FAQ/is-polymarket-the-house.md +https://docs.polymarket.com/polymarket-learn/FAQ/polling.md +https://docs.polymarket.com/polymarket-learn/FAQ/recover-missing-deposit.md +https://docs.polymarket.com/polymarket-learn/FAQ/sell-early.md +https://docs.polymarket.com/polymarket-learn/FAQ/support.md +https://docs.polymarket.com/polymarket-learn/FAQ/wen-token.md +https://docs.polymarket.com/polymarket-learn/FAQ/what-are-prediction-markets.md +https://docs.polymarket.com/polymarket-learn/FAQ/why-do-i-need-crypto.md + +## Polymarket Learn - Deposits +https://docs.polymarket.com/polymarket-learn/deposits/coinbase.md +https://docs.polymarket.com/polymarket-learn/deposits/how-to-withdraw.md +https://docs.polymarket.com/polymarket-learn/deposits/large-cross-chain-deposits.md +https://docs.polymarket.com/polymarket-learn/deposits/moonpay.md +https://docs.polymarket.com/polymarket-learn/deposits/supported-tokens.md +https://docs.polymarket.com/polymarket-learn/deposits/usdc-on-eth.md + +## Polymarket Learn - Get Started +https://docs.polymarket.com/polymarket-learn/get-started/how-to-deposit.md +https://docs.polymarket.com/polymarket-learn/get-started/how-to-signup.md +https://docs.polymarket.com/polymarket-learn/get-started/making-your-first-trade.md +https://docs.polymarket.com/polymarket-learn/get-started/what-is-polymarket.md + +## Polymarket Learn - Markets +https://docs.polymarket.com/polymarket-learn/markets/dispute.md +https://docs.polymarket.com/polymarket-learn/markets/how-are-markets-clarified.md +https://docs.polymarket.com/polymarket-learn/markets/how-are-markets-created.md +https://docs.polymarket.com/polymarket-learn/markets/how-are-markets-resolved.md + +## Polymarket Learn - Trading +https://docs.polymarket.com/polymarket-learn/trading/fees.md +https://docs.polymarket.com/polymarket-learn/trading/holding-rewards.md +https://docs.polymarket.com/polymarket-learn/trading/how-are-prices-calculated.md +https://docs.polymarket.com/polymarket-learn/trading/limit-orders.md +https://docs.polymarket.com/polymarket-learn/trading/liquidity-rewards.md +https://docs.polymarket.com/polymarket-learn/trading/maker-rebates-program.md +https://docs.polymarket.com/polymarket-learn/trading/market-orders.md +https://docs.polymarket.com/polymarket-learn/trading/no-limits.md +https://docs.polymarket.com/polymarket-learn/trading/using-the-orderbook.md + +## Missing from API Reference - Core +https://docs.polymarket.com/api-reference/core/get-positions-for-a-market.md + +## Missing from Builders +https://docs.polymarket.com/developers/builders/examples.md diff --git a/docs/developers/market-makers/maker-rebates-program.md b/docs/developers/market-makers/maker-rebates-program.md index 4ce6a6f..eb16684 100644 --- a/docs/developers/market-makers/maker-rebates-program.md +++ b/docs/developers/market-makers/maker-rebates-program.md @@ -6,7 +6,7 @@ > Technical guide for handling taker fees and earning maker rebates on Polymarket -Polymarket has enabled taker fees on **15-minute crypto markets**, **NCAAB (college basketball)**, and **Serie A** markets. +Polymarket has enabled taker fees on **15-minute crypto markets**, **5-minute crypto markets**, **NCAAB (college basketball)**, and **Serie A** markets. These fees fund a Maker Rebates program that pays daily USDC rebates to liquidity providers. @@ -112,21 +112,21 @@ fee = C × p × feeRate × (p × (1 - p))^exponent Where **C** = number of shares traded and **p** = price of the shares. The fee parameters differ by market type: -| Parameter | Sports (NCAAB, Serie A) | 15-Min Crypto | -| -------------- | ----------------------- | ------------- | -| Fee Rate | 0.0175 | 0.25 | -| Exponent | 1 | 2 | -| Maker Rebate % | 25% | 20% | +| Parameter | Sports (NCAAB, Serie A) | 5-Min & 15-Min Crypto | +| -------------- | ----------------------- | --------------------- | +| Fee Rate | 0.0175 | 0.25 | +| Exponent | 1 | 2 | +| Maker Rebate % | 25% | 20% | Taker fees are calculated in USDC and vary based on the share price. However, fees are collected in shares on buy orders and USDC on sell orders. The effective rate **peaks at 50%** probability and decreases symmetrically toward the extremes. -Fee Curves +Fee Curves ### Fee Table (100 shares) - + | Price | Trade Value | Fee (USDC) | Effective Rate | | ------ | ----------- | ---------- | -------------- | | \$0.01 | \$1 | \$0.00 | 0.00% | @@ -208,6 +208,7 @@ Each market's rebate pool is funded by taker fees collected in that market. The | Market Type | Period | Maker Rebate | Distribution Method | | ----------------------- | ------------- | ------------ | ------------------- | | 15-Min Crypto | Jan 19, 2026+ | 20% | Fee-curve weighted | +| 5-Min Crypto | Feb 12, 2026+ | 20% | Fee-curve weighted | | Sports (NCAAB, Serie A) | Feb 18, 2026+ | 25% | Fee-curve weighted | The rebate percentage is at the sole discretion of Polymarket and may change over time. @@ -219,6 +220,7 @@ The rebate percentage is at the sole discretion of Polymarket and may change ove The following market types have fees enabled: * **15-minute crypto markets** +* **5-minute crypto markets** * **NCAAB (college basketball) markets** (starting February 18, 2026 for new markets) * **Serie A markets** (starting February 18, 2026 for new markets) diff --git a/docs/polymarket-learn/FAQ/recover-missing-deposit.md b/docs/polymarket-learn/FAQ/recover-missing-deposit.md new file mode 100644 index 0000000..ce793d4 --- /dev/null +++ b/docs/polymarket-learn/FAQ/recover-missing-deposit.md @@ -0,0 +1,27 @@ +> ## Documentation Index +> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt +> Use this file to discover all available pages before exploring further. + +# Recover Missing Deposit + +> If you deposited the wrong cryptocurrency on Ethereum or Polygon, use these tools to recover those funds. + +### Recover on Ethereum + +Use this tool if you deposited the wrong token on Ethereum. + +1. Go to [https://recovery.polymarket.com/](https://recovery.polymarket.com/) and sign in with your Polymarket account or connect the wallet you use on Polymarket. + +2. Select the asset you incorrectly deposited. + +3. You’ll then see the asset balance displayed, and will have the ability to recover those funds to your specified wallet. + +### Recover on Polygon + +Use this tool if you deposited the wrong token on Polygon. + +1. Go to [https://matic-recovery.polymarket.com/](https://matic-recovery.polymarket.com/) and sign in with your Polymarket account or connect the wallet you use on Polymarket. + +2. Select the asset you incorrectly deposited. + +3. You’ll then see the asset balance displayed, and will have the ability to recover those funds to your specified wallet. diff --git a/docs/polymarket-learn/get-started/how-to-signup.md b/docs/polymarket-learn/get-started/how-to-signup.md new file mode 100644 index 0000000..a13918c --- /dev/null +++ b/docs/polymarket-learn/get-started/how-to-signup.md @@ -0,0 +1,72 @@ +> ## Documentation Index +> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt +> Use this file to discover all available pages before exploring further. + +# How to Sign-Up + +> How to create a Polymarket account. + + + Need Help? + We're available to guide you through the sign-up process on [Discord](https://discord.gg/polymarket) + + +### Email or Google Sign-Up + +Signing up for Polymarket with your email address or Google account is quick, simple, and secure. + + + + Click **Sign Up** on the top right of the Polymarket homepage. + + + + Enter your email address and click **continue**. + + *You can also use your Google account to sign in and follow the same procedure.* + + + + **Copy the security code** provided by Magic. + + + + You’ll receive an email with the subject “Log in to Polymarket”. Open the email, and click the **Log in to Polymarket** button. + + In the new window, enter or **paste the security code** from the previous step. + + Note: This page will be hosted on auth.magic.link. + + You'll see a Login Complete message. Return to your original Polymarket window. + + + + Back on Polymarket, you'll be signed in. Choose your display name, agree to the terms of service, opt into email updates, and get started trading. + + + +### Crypto Wallet Sign-Up + +Polymarket supports most crypto wallets, including MetaMask, Coinbase Wallet, and others via WalletConnect. + + + + Click Sign Up on the Polymarket homepage. + + + + Choose your preferred wallet and follow the prompts to connect it to Polymarket. Ensure you are connected to the Polygon Network, your wallet may prompt you to switch networks. + + + + Sign the transaction prompt(s) on your wallet app or extension. + + + + You're signed in! Choose your display name, agree to the terms of service, opt into email updates, and start trading. + + + + + If you have MetaMask or Coinbase Wallet browser extensions installed but wish to connect using their mobile apps, you'll need to disable the extensions in your browser settings and reload Polymarket. + diff --git a/docs/polymarket-learn/trading/holding-rewards.md b/docs/polymarket-learn/trading/holding-rewards.md new file mode 100644 index 0000000..e06b822 --- /dev/null +++ b/docs/polymarket-learn/trading/holding-rewards.md @@ -0,0 +1,56 @@ +> ## Documentation Index +> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt +> Use this file to discover all available pages before exploring further. + +# Holding Rewards + +## What are we doing? + +To keep long-term pricing accurate, we're paying 4.00% annualized Holding Reward based on your total position value in certain polymarkets. We anticipate rolling out a new reward and oracle-resolution system later this year — at which point there will be a simple 1-click migration. + +## Reward Rate and Conditions + +The current rate is set at 4.00% and applies to all eligible positions. This rate is variable and subject to change at Polymarket's discretion. We also reserve the right to introduce limits to the total amount of rewards paid out at any time. This iteration of rewards is funded through the Polymarket Treasury. + +Your total position value is randomly sampled once each hour, and the reward is distributed daily. Your rewards are calculated based on the total position value of your eligible positions at the time of evaluation. + +### **Total Position Value Computation** + +For each eligible polymarket, we calculate the eligible position in the following way: + +**Position Valuation**: + +* Based on your current "Yes" and "No" shares and the most recent mid-price for each outcome. + +### **Example** + +If you hold at time of sample: + +* 30,000 “Yes” shares at a price of **\$0.53** +* 10,000 “No” shares at a price of **\$0.45** + +**Total Position Value** = + +→ `(30000 × 0.53) + (10000 × 0.45)` + +→ `$15,900 + $4,500 = $20,400` + +**Hourly Holding Reward Calculation** (based on 4.00% Annual Reward): + +→ `$20400 × (0.04 / 365 / 24) ≈ $.09315068493` + +## Eligible Events: + +* [Presidential Election Winner 2028](https://polymarket.com/event/presidential-election-winner-2028) +* [Republican Presidential Nominee 2028](https://polymarket.com/event/republican-presidential-nominee-2028) +* [Democratic Presidential Nominee 2028](https://polymarket.com/event/democratic-presidential-nominee-2028) +* [Which party wins 2028 US Presidential Election?](https://polymarket.com/event/which-party-wins-2028-us-presidential-election) +* [Balance of Power: 2026 Midterms](https://polymarket.com/event/balance-of-power-2026-midterms) +* [Which party will win the Senate in 2026?](https://polymarket.com/event/which-party-will-win-the-senate-in-2026) +* [Which party will win the House in 2026?](https://polymarket.com/event/which-party-will-win-the-house-in-2026) +* [Erdoğan out before 2027?](https://polymarket.com/event/erdoan-out-before-2027) +* [Zelenskyy out as Ukraine president before 2027?](https://polymarket.com/event/zelenskyy-out-as-ukraine-president-before-2027) +* [Netanyahu out before 2027?](https://polymarket.com/event/netanyahu-out-before-2027) +* [Xi Jinping out before 2027?](https://polymarket.com/event/xi-jinping-out-before-2027) +* [Putin out as President of Russia before 2027?](https://polymarket.com/event/putin-out-before-2027) +* [Russia x Ukraine ceasefire before 2027?](https://polymarket.com/event/russia-x-ukraine-ceasefire-before-2027) diff --git a/docs/polymarket-learn/trading/liquidity-rewards.md b/docs/polymarket-learn/trading/liquidity-rewards.md new file mode 100644 index 0000000..23f56ab --- /dev/null +++ b/docs/polymarket-learn/trading/liquidity-rewards.md @@ -0,0 +1,57 @@ +> ## Documentation Index +> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt +> Use this file to discover all available pages before exploring further. + +# Liquidity Rewards + +> Learn how to earn rewards merely by placing trades on Polymarket + +With Polymarket's Liquidity Rewards Program, you can earn money by placing limit orders that help keep the market active and balanced. + +## Overview + +* The closer your orders are to the market's average price, the more you earn. + +* The reward amount depends on how helpful your orders are in terms of size and pricing compared to others. + +* The more competitive your limit orders, the more you can make. + +* You get paid daily based on how much your orders add to the market, and can use our [Rewards page](https://polymarket.com/rewards) to check your current earnings for the day, which markets have rewards in place, as well as how much. + +* The minimum reward payout is \$1; amounts below this will not be paid. + + + + + +Simply put, the more you help the market by placing good orders, the more rewards you earn! + +## Seeing Rewards in the Order Book + +### Viewing Rewards + +The total rewards, max spread, and minimum shares required to earn rewards vary by market. You can view the rewards for a given market in its Order Book. + +* On the Polymarket order book, you can hover over the Rewards text to see the amount of rewards available in total on each market. + +* The blue highlighted lines correspond to the max spread — meaning the farthest distance your limit order can be from the midpoint of the market to earn rewards. + +* In the example below, because the max spread is 3c, every order within 3c of the midpoint is eligible for rewards. If the midpoint is \< \$0.10, you need to have orders on both sides to qualify. + + + + + +### Earning Rewards + +When your orders are earning rewards you’ll see a blue highlight around the clock icon, as shown below: + + + + + +## Learn more + +Rewards are paid out automatically every day at \~midnight UTC. Your history on your portfolio page will reflect rewards paid to your address. + +To read more about the specific calculations and formulas that determine rewards, visit our [Liquidity Rewards Documentation](/developers/market-makers/liquidity-rewards). diff --git a/docs/polymarket-learn/trading/maker-rebates-program.md b/docs/polymarket-learn/trading/maker-rebates-program.md new file mode 100644 index 0000000..0a94d2e --- /dev/null +++ b/docs/polymarket-learn/trading/maker-rebates-program.md @@ -0,0 +1,131 @@ +> ## Documentation Index +> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt +> Use this file to discover all available pages before exploring further. + +# Maker Rebates Program + +Polymarket has enabled taker fees on **15-minute crypto markets**, **5-minute crypto markets**, **NCAAB (college basketball)**, and **Serie A** markets. These fees fund a **Maker Rebates** program that pays daily USDC rebates to liquidity providers. + + + Starting **Wednesday, February 18th, 2026 at midnight (UTC)**, taker fees and maker rebates will apply to all **new** NCAAB and Serie A markets created after that time. Existing markets are not affected. The first payout will be on February 19th at midnight (UTC). + + +## Why Expand Maker Rebates? + +Sports markets benefit from the same dynamics as our 15-minute crypto and 5-minute crypto markets. When liquidity is deeper: + +* Spreads tend to be tighter +* Price impact is lower +* Fills are more reliable +* Markets are more resilient during volatility + +Maker Rebates incentivize consistent, competitive quoting so everyone gets a better trading experience. + +### Program Funding + +Maker Rebates are funded by taker fees collected in eligible markets. A percentage of these fees are redistributed to makers who keep the markets liquid. The rebate percentage differs by market type. + +| Market Type | Period | Maker Rebate | Distribution Method | +| ----------------------- | ------------- | ------------ | ------------------- | +| 15-Min Crypto | Jan 19, 2026+ | 20% | Fee-curve weighted | +| 5-Min Crypto | Feb 12, 2026+ | 20% | Fee-curve weighted | +| Sports (NCAAB, Serie A) | Feb 18, 2026+ | 25% | Fee-curve weighted | + + + Polymarket collects taker fees in eligible markets (15-minute crypto, 5-minute crypto, NCAAB, and Serie A). The rebate percentage is at the sole discretion of Polymarket and may change over time. + + +## Taker Fee Structure + +Taker fees are calculated in USDC and vary based on the share price. However, fees are collected in shares on buy orders and USDC on sell orders. +Fees are highest at 50% probability and lowest at the extremes (near 0% or 100%). + +Fee Curves + +### Fee Table (100 shares) + + + + | Price | Trade Value | Fee (USDC) | Effective Rate | + | ------ | ----------- | ---------- | -------------- | + | \$0.01 | \$1 | \$0.00 | 0.00% | + | \$0.05 | \$5 | \$0.003 | 0.06% | + | \$0.10 | \$10 | \$0.02 | 0.20% | + | \$0.15 | \$15 | \$0.06 | 0.41% | + | \$0.20 | \$20 | \$0.13 | 0.64% | + | \$0.25 | \$25 | \$0.22 | 0.88% | + | \$0.30 | \$30 | \$0.33 | 1.10% | + | \$0.35 | \$35 | \$0.45 | 1.29% | + | \$0.40 | \$40 | \$0.58 | 1.44% | + | \$0.45 | \$45 | \$0.69 | 1.53% | + | \$0.50 | \$50 | \$0.78 | **1.56%** | + | \$0.55 | \$55 | \$0.84 | 1.53% | + | \$0.60 | \$60 | \$0.86 | 1.44% | + | \$0.65 | \$65 | \$0.84 | 1.29% | + | \$0.70 | \$70 | \$0.77 | 1.10% | + | \$0.75 | \$75 | \$0.66 | 0.88% | + | \$0.80 | \$80 | \$0.51 | 0.64% | + | \$0.85 | \$85 | \$0.35 | 0.41% | + | \$0.90 | \$90 | \$0.18 | 0.20% | + | \$0.95 | \$95 | \$0.05 | 0.06% | + | \$0.99 | \$99 | \$0.00 | 0.00% | + + The maximum effective fee rate is **1.56%** at 50% probability. Fees decrease symmetrically toward both extremes. + + + + | Price | Trade Value | Fee (USDC) | Effective Rate | + | ------ | ----------- | ---------- | -------------- | + | \$0.01 | \$1 | \$0.00 | 0.02% | + | \$0.05 | \$5 | \$0.00 | 0.08% | + | \$0.10 | \$10 | \$0.02 | 0.16% | + | \$0.15 | \$15 | \$0.03 | 0.22% | + | \$0.20 | \$20 | \$0.06 | 0.28% | + | \$0.25 | \$25 | \$0.08 | 0.33% | + | \$0.30 | \$30 | \$0.11 | 0.37% | + | \$0.35 | \$35 | \$0.14 | 0.40% | + | \$0.40 | \$40 | \$0.17 | 0.42% | + | \$0.45 | \$45 | \$0.19 | 0.43% | + | \$0.50 | \$50 | \$0.22 | **0.44%** | + | \$0.55 | \$55 | \$0.24 | 0.43% | + | \$0.60 | \$60 | \$0.25 | 0.42% | + | \$0.65 | \$65 | \$0.26 | 0.40% | + | \$0.70 | \$70 | \$0.26 | 0.37% | + | \$0.75 | \$75 | \$0.25 | 0.33% | + | \$0.80 | \$80 | \$0.22 | 0.28% | + | \$0.85 | \$85 | \$0.19 | 0.22% | + | \$0.90 | \$90 | \$0.14 | 0.16% | + | \$0.95 | \$95 | \$0.08 | 0.08% | + | \$0.99 | \$99 | \$0.02 | 0.02% | + + The maximum effective fee rate is **0.44%** at 50% probability. Fees decrease symmetrically toward both extremes. + + + +### Fee Precision + +Fees are rounded to 4 decimal places. The smallest fee charged is 0.0001 USDC. Anything smaller rounds to zero, so very small trades near the extremes may incur no fee at all. + +## FAQ + + + + Rebates are proportional to your share of executed maker liquidity in each eligible market. Totals are calculated per market, so you only compete with other makers in the same market. + + + + 15-minute crypto markets, 5-minute crypto markets, and starting February 18, 2026, NCAAB and Serie A markets. + + + + No. Fees apply only to 15-minute crypto, 5-minute crypto, NCAAB, and Serie A markets. All other markets remain fee-free. + + + +## For API Users + +If you trade programmatically, you'll need to update your client to handle fees correctly. + + + Technical documentation for handling fees in your trading code + diff --git a/docs/polymarket-learn/trading/market-orders.md b/docs/polymarket-learn/trading/market-orders.md new file mode 100644 index 0000000..78f3887 --- /dev/null +++ b/docs/polymarket-learn/trading/market-orders.md @@ -0,0 +1,43 @@ +> ## Documentation Index +> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt +> Use this file to discover all available pages before exploring further. + +# Market Orders + +> How to buy shares. + +# Market Orders + +Once you've [signed up](../get-started/how-to-signup) and [deposited funds](../get-started/how-to-deposit), you're ready to start trading on Polymarket. Here's a step-by-step guide to get you started. + +## Video Walkthrough + +