From a1a79b8a725c5273c202a8acec5bf7786967f6a0 Mon Sep 17 00:00:00 2001 From: GLaDOS Date: Thu, 9 Jul 2026 14:09:56 +0200 Subject: [PATCH] docs: sync with official Polymarket docs (2026-07-09) Updates across 25 files: - api-reference/core: get-user-combo-activity, get-user-combo-positions - dev-tooling/python - polymarket-learn/FAQ: wen-token, what-are-prediction-markets, why-do-i-need-crypto - polymarket-learn/deposits: coinbase, how-to-withdraw, moonpay, usdc-on-eth - polymarket-learn/get-started: how-to-deposit, how-to-signup, making-your-first-trade, what-is-polymarket - polymarket-learn/markets: dispute, how-are-markets-clarified, how-are-markets-created, how-are-markets-resolved - polymarket-learn/trading: holding-rewards, how-are-prices-calculated, limit-orders, liquidity-rewards, market-orders, no-limits - resources/error-codes --- .../core/get-user-combo-activity.md | 15 +++++- .../core/get-user-combo-positions.md | 48 +++++++++++++++++-- docs/dev-tooling/python.md | 4 ++ docs/polymarket-learn/FAQ/wen-token.md | 4 +- .../FAQ/what-are-prediction-markets.md | 4 +- .../FAQ/why-do-i-need-crypto.md | 4 +- docs/polymarket-learn/deposits/coinbase.md | 4 +- .../deposits/how-to-withdraw.md | 4 +- docs/polymarket-learn/deposits/moonpay.md | 4 +- docs/polymarket-learn/deposits/usdc-on-eth.md | 4 +- .../get-started/how-to-deposit.md | 4 +- .../get-started/how-to-signup.md | 4 +- .../get-started/making-your-first-trade.md | 10 ++-- .../get-started/what-is-polymarket.md | 4 +- docs/polymarket-learn/markets/dispute.md | 4 +- .../markets/how-are-markets-clarified.md | 4 +- .../markets/how-are-markets-created.md | 4 +- .../markets/how-are-markets-resolved.md | 4 +- .../trading/holding-rewards.md | 4 +- .../trading/how-are-prices-calculated.md | 4 +- docs/polymarket-learn/trading/limit-orders.md | 4 +- .../trading/liquidity-rewards.md | 4 +- .../polymarket-learn/trading/market-orders.md | 10 ++-- docs/polymarket-learn/trading/no-limits.md | 4 +- docs/resources/error-codes.md | 4 ++ 25 files changed, 117 insertions(+), 50 deletions(-) diff --git a/docs/api-reference/core/get-user-combo-activity.md b/docs/api-reference/core/get-user-combo-activity.md index cf19360..5fdc115 100644 --- a/docs/api-reference/core/get-user-combo-activity.md +++ b/docs/api-reference/core/get-user-combo-activity.md @@ -71,6 +71,14 @@ paths: default: 0 minimum: 0 maximum: 10000 + - in: query + name: cursor + schema: + type: string + description: >- + Opaque continuation token from a previous response's + pagination.next_cursor. When present it supersedes offset (which is + ignored). Invalid, tampered, or cross-endpoint tokens return 400. responses: '200': description: Success @@ -198,7 +206,12 @@ components: next_cursor: type: string nullable: true - description: Opaque cursor for the next page; null when has_more is false. + description: >- + Opaque signed cursor for the next page; null when has_more is false. + Pass it back verbatim as ?cursor= on the next request (keep the same + sort where the endpoint has one). Never parse or construct it. On + cursor-enabled endpoints this makes deep pagination O(page) and + stable against concurrent inserts. ComboLeg: type: object properties: diff --git a/docs/api-reference/core/get-user-combo-positions.md b/docs/api-reference/core/get-user-combo-positions.md index 871f223..9e40600 100644 --- a/docs/api-reference/core/get-user-combo-positions.md +++ b/docs/api-reference/core/get-user-combo-positions.md @@ -62,6 +62,7 @@ paths: - first_entry_desc - entry_cost_desc - resolved_at_desc + - updated_asc default: current_value_desc - in: query name: market_id @@ -81,14 +82,43 @@ paths: type: integer default: 20 minimum: 0 - maximum: 100 + maximum: 1000 - in: query name: offset schema: type: integer default: 0 minimum: 0 - maximum: 10000 + maximum: 100000 + - in: query + name: updatedAfter + schema: + type: integer + description: >- + Incremental-sync watermark (epoch seconds, inclusive): only rows + whose updated_at is at or after this time. Positions mutate on + resolution and redemption, so this catches changes a creation-time + filter cannot. In sync mode + (updatedAfter/updatedBefore/sort=updated_asc) every live row is + returned regardless of balance, and the effective upper bound is + clamped ~90s behind now (commit-visibility safety lag) — very recent + rows appear on the next poll. Rows at the boundary may re-deliver: + upsert by (combo_condition_id, combo_position_id). + - in: query + name: updatedBefore + schema: + type: integer + description: >- + Optional upper bound (epoch seconds, inclusive) for updated_at; + clamped to the safety lag. Must be >= updatedAfter. + - in: query + name: cursor + schema: + type: string + description: >- + Opaque continuation token from a previous response's + pagination.next_cursor. When present it supersedes offset (which is + ignored). Invalid, tampered, or cross-endpoint tokens return 400. responses: '200': description: Success @@ -193,6 +223,13 @@ components: resolved_at: type: string nullable: true + updated_at: + type: string + description: >- + Last-modified time (UTC, ISO 8601). Bumps on any recompute of the + row (trade, redemption, resolution classification) — the + incremental-sync watermark field. Omitted on responses served by the + legacy backend. legs_total: type: integer legs_resolved: @@ -218,7 +255,12 @@ components: next_cursor: type: string nullable: true - description: Opaque cursor for the next page; null when has_more is false. + description: >- + Opaque signed cursor for the next page; null when has_more is false. + Pass it back verbatim as ?cursor= on the next request (keep the same + sort where the endpoint has one). Never parse or construct it. On + cursor-enabled endpoints this makes deep pagination O(page) and + stable against concurrent inserts. ComboLeg: type: object properties: diff --git a/docs/dev-tooling/python.md b/docs/dev-tooling/python.md index 5619c8a..a7e1312 100644 --- a/docs/dev-tooling/python.md +++ b/docs/dev-tooling/python.md @@ -1102,6 +1102,10 @@ Secure clients expose the API credentials created for the authenticated session. ## Changelog +### `0.1.0b16` + +* Fixed Deposit Wallet trading setup approvals to use the current Protocol V2 auto-redeem operator. + ### `0.1.0b15` * Added support for Perps. diff --git a/docs/polymarket-learn/FAQ/wen-token.md b/docs/polymarket-learn/FAQ/wen-token.md index 1e78696..31df57b 100644 --- a/docs/polymarket-learn/FAQ/wen-token.md +++ b/docs/polymarket-learn/FAQ/wen-token.md @@ -1,4 +1,4 @@ -Does Polymarket Have a Token? | Polymarket Help Center
Skip to main content

Does Polymarket Have a Token?

All trading and liquidity rewards are in pUSD, Polymarket's official collateral token. pUSD is a standard ERC-20 token on Polygon, backed by USDC.

Polymarket has not announced plans for any airdrop or token generation event. Be wary of scams claiming airdrops, giveaways, etc. Announcements will only come from official channels.

If in doubt, refer to official Polymarket communication channels:


​

Related Articles
Recover Missing Deposit
Does Polymarket have an API?
Polymarket Exchange Upgrade: April 28, 2026
How to Delete Your Polymarket Account
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

Does Polymarket Have a Token?

All trading and liquidity rewards are in pUSD, Polymarket's official collateral token. pUSD is a standard ERC-20 token on Polygon, backed by USDC.

Polymarket has not announced plans for any airdrop or token generation event. Be wary of scams claiming airdrops, giveaways, etc. Announcements will only come from official channels.

If in doubt, refer to official Polymarket communication channels:


​

Related Articles
Recover Missing Deposit
Does Polymarket have an API?
Polymarket Exchange Upgrade: April 28, 2026
How to Delete Your Polymarket Account
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/what-are-prediction-markets.md b/docs/polymarket-learn/FAQ/what-are-prediction-markets.md index 970b1eb..3f89678 100644 --- a/docs/polymarket-learn/FAQ/what-are-prediction-markets.md +++ b/docs/polymarket-learn/FAQ/what-are-prediction-markets.md @@ -1,4 +1,4 @@ -What is a Prediction Market? | Polymarket Help Center
Skip to main content

What is a Prediction Market?

How people collectively forecast the future.

A prediction market is a platform where people can make predictions 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.

Related Articles
What is Polymarket
Is Polymarket The House?
Maker Rebates Program
Trading Fees
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

What is a Prediction Market?

How people collectively forecast the future.

A prediction market is a platform where people can make predictions 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.

Related Articles
What is Polymarket
Is Polymarket The House?
Maker Rebates Program
Trading Fees
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/why-do-i-need-crypto.md b/docs/polymarket-learn/FAQ/why-do-i-need-crypto.md index c0503b1..8cdaf2b 100644 --- a/docs/polymarket-learn/FAQ/why-do-i-need-crypto.md +++ b/docs/polymarket-learn/FAQ/why-do-i-need-crypto.md @@ -1,4 +1,4 @@ -Why Crypto? | Polymarket Help Center
Skip to main content

Why Crypto?

Why Polymarket uses crypto and blockchain technology to create the world’s largest Prediction market.

Polymarket operates on Polygon, a proof-of-stake layer two blockchain built on Ethereum. All transactions are denominated in USDC, a US-dollar pegged stablecoin.This architecture offers several advantages over traditional prediction markets:

​Why USDC?

​Stable Value

Polymarket denominates trades in USDC, which is pegged 1:1 to the US Dollar. This shields you from the volatility associated with other cryptocurrencies and offers a stable medium for trading.

​Regulated Reserves

USDC operates in adherence to regulatory standards and is backed by reserved assets.

​Transparency

Blockchain technology facilitates transparency, as all transactions are recorded publicly.

​Global Reach

Research has shown that wide availability of prediction markets increases their accuracy. Using decentralized blockchain technology removes the need for a central authority in trading, which fosters fairness and open participation around the globe.

Related Articles
What is Polymarket
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

Why Crypto?

Why Polymarket uses crypto and blockchain technology to create the world’s largest Prediction market.

Polymarket operates on Polygon, a proof-of-stake layer two blockchain built on Ethereum. All transactions are denominated in USDC, a US-dollar pegged stablecoin.This architecture offers several advantages over traditional prediction markets:

​Why USDC?

​Stable Value

Polymarket denominates trades in USDC, which is pegged 1:1 to the US Dollar. This shields you from the volatility associated with other cryptocurrencies and offers a stable medium for trading.

​Regulated Reserves

USDC operates in adherence to regulatory standards and is backed by reserved assets.

​Transparency

Blockchain technology facilitates transparency, as all transactions are recorded publicly.

​Global Reach

Research has shown that wide availability of prediction markets increases their accuracy. Using decentralized blockchain technology removes the need for a central authority in trading, which fosters fairness and open participation around the globe.

Related Articles
What is Polymarket
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/deposits/coinbase.md b/docs/polymarket-learn/deposits/coinbase.md index 4d2c1c0..1c34fcd 100644 --- a/docs/polymarket-learn/deposits/coinbase.md +++ b/docs/polymarket-learn/deposits/coinbase.md @@ -1,4 +1,4 @@ -How to Deposit | Polymarket Help Center
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/deposits/how-to-withdraw.md b/docs/polymarket-learn/deposits/how-to-withdraw.md index beebb25..ef92037 100644 --- a/docs/polymarket-learn/deposits/how-to-withdraw.md +++ b/docs/polymarket-learn/deposits/how-to-withdraw.md @@ -1,4 +1,4 @@ -How to Withdraw | Polymarket Help Center
Skip to main content

How to Withdraw

Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How to Withdraw

Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/deposits/moonpay.md b/docs/polymarket-learn/deposits/moonpay.md index 3f43758..e9610d9 100644 --- a/docs/polymarket-learn/deposits/moonpay.md +++ b/docs/polymarket-learn/deposits/moonpay.md @@ -1,4 +1,4 @@ -How to Deposit | Polymarket Help Center
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/deposits/usdc-on-eth.md b/docs/polymarket-learn/deposits/usdc-on-eth.md index 79c038f..53f3cca 100644 --- a/docs/polymarket-learn/deposits/usdc-on-eth.md +++ b/docs/polymarket-learn/deposits/usdc-on-eth.md @@ -1,4 +1,4 @@ -How to Deposit | Polymarket Help Center
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/get-started/how-to-deposit.md b/docs/polymarket-learn/get-started/how-to-deposit.md index 8713c3a..f80036a 100644 --- a/docs/polymarket-learn/get-started/how-to-deposit.md +++ b/docs/polymarket-learn/get-started/how-to-deposit.md @@ -1,4 +1,4 @@ -How to Deposit | Polymarket Help Center
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How to Deposit

How to add cash to your balance on Polymarket.

To deposit funds into your Polymarket account:

  1. Click Deposit.

  2. Select your deposit method (for example, Transfer Crypto).

  3. Choose the token and network (chain) you want to use. Each Polymarket account is assigned a fixed crypto deposit address tied to the specific profile. This address cannot be changed or regenerated manually. Deposit addresses are unique to the blockchain network, so your address on Solana or Bitcoin may differ from your Polygon/EVM address.

  4. Copy your deposit address. Always verify the deposit address displayed in your profile before sending funds. Ensure you are using the same wallet and login method as when you created your account to avoid discrepancies. Test with a small amount to confirm compatibility before transferring larger amounts.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance. Note that deposits below the minimum thresholds (e.g., $20 for Ethereum, $3 for Solana) will remain pending until the cumulative amount meets the required minimum.

Always double-check the network and deposit address before sending funds. Transactions sent to the wrong chain or address cannot be reversed.

If you mistakenly send funds to the wrong address or network, you can use Polymarket’s on-chain recovery tool to attempt recovery. Follow the steps provided in the recovery portal to retrieve your funds.

Related Articles
Recover Missing Deposit
Liquidity Rewards
Maker Rebates Program
How to Sign-Up
How to Withdraw
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/get-started/how-to-signup.md b/docs/polymarket-learn/get-started/how-to-signup.md index f9ab53b..0879c28 100644 --- a/docs/polymarket-learn/get-started/how-to-signup.md +++ b/docs/polymarket-learn/get-started/how-to-signup.md @@ -1,4 +1,4 @@ -How to Sign-Up | Polymarket Help Center
Skip to main content

How to Sign-Up

How to create a Polymarket account.

There are three ways to sign up for Polymarket.

Sign Up With Google

  1. Click Sign Up.

  2. Select Continue with Google.

  3. Connect your Google account.

  4. Complete the signup process.

You can now log in using your Google account.

Sign Up with Email

  1. Click Sign Up.

  2. Enter your email address and click Continue.

  3. Enter the 6-digit code sent to your email.

  4. You're signed up.

You can now log in using your email and 6-digit code.

Never share your 6-digit login code - not even with Polymarket staff. If someone gains access to your code, they can access your account and funds. Polymarket support cannot recover lost funds caused by shared codes.

Sign Up with Crypto Wallet

  1. Click Sign Up.

  2. Connect your crypto wallet (such as MetaMask, Rabby, or Phantom).

  3. Sign a message to Connect your wallet to Polymarket.

  4. Sign another message to Enable Trading.

  5. You're signed up.

You can now log in using your connected wallet.

Related Articles
Recover Missing Deposit
How Do I Export My Key?
Is My Money Safe?
How to Deposit
Referral Program
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How to Sign-Up

How to create a Polymarket account.

There are three ways to sign up for Polymarket.

Sign Up With Google

  1. Click Sign Up.

  2. Select Continue with Google.

  3. Connect your Google account.

  4. Complete the signup process.

You can now log in using your Google account.

Sign Up with Email

  1. Click Sign Up.

  2. Enter your email address and click Continue.

  3. Enter the 6-digit code sent to your email.

  4. You're signed up.

You can now log in using your email and 6-digit code.

Never share your 6-digit login code - not even with Polymarket staff. If someone gains access to your code, they can access your account and funds. Polymarket support cannot recover lost funds caused by shared codes.

Sign Up with Crypto Wallet

  1. Click Sign Up.

  2. Connect your crypto wallet (such as MetaMask, Rabby, or Phantom).

  3. Sign a message to Connect your wallet to Polymarket.

  4. Sign another message to Enable Trading.

  5. You're signed up.

You can now log in using your connected wallet.

Related Articles
Recover Missing Deposit
How Do I Export My Key?
Is My Money Safe?
How to Deposit
Referral Program
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/get-started/making-your-first-trade.md b/docs/polymarket-learn/get-started/making-your-first-trade.md index 6041c77..7b25901 100644 --- a/docs/polymarket-learn/get-started/making-your-first-trade.md +++ b/docs/polymarket-learn/get-started/making-your-first-trade.md @@ -208,7 +208,7 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even .size(dec!(10)) .side(Side::Buy) .order_type(OrderType::GTD) - .expiration(Utc::now() + TimeDelta::hours(1)) + .expiration(Utc::now() + TimeDelta::minutes(1) + TimeDelta::hours(1)) .build() .await?; let signed = client.sign(&signer, order).await?; @@ -217,9 +217,11 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even - There is a security threshold of one minute on GTD expiration. To set an - effective lifetime of N seconds, use `now + 60 + N`. For example, for a - 30-second effective lifetime, set the expiration to `now + 60 + 30`. + GTD orders expire one minute before their stated expiration as a security + threshold. To set an effective lifetime of N seconds, use `now + 60 + N`. + In addition, the expiration must be at least three minutes in the future — + orders expiring sooner are rejected — so the minimum effective lifetime is + about two minutes. *** diff --git a/docs/polymarket-learn/get-started/what-is-polymarket.md b/docs/polymarket-learn/get-started/what-is-polymarket.md index 9640621..5f36aef 100644 --- a/docs/polymarket-learn/get-started/what-is-polymarket.md +++ b/docs/polymarket-learn/get-started/what-is-polymarket.md @@ -1,4 +1,4 @@ -What is Polymarket | Polymarket Help Center
Skip to main content

What is Polymarket

Polymarket is the world’s largest prediction market, allowing you to stay informed and profit from your knowledge by betting on future events across various topics.

Studies show prediction markets are often more accurate than pundits because they combine news, polls, and expert opinions into a single value that represents the market’s view of an event’s odds. Our markets reflect accurate, unbiased, and real-time probabilities for the events that matter most to you. Markets seek truth.

​Quick Overview

  • On Polymarket, you can trade on future event outcomes (i.e. “Will TikTok be banned in the U.S. this year?”)

  • Shares in event outcomes are between 0.00 and 1.00, and every pair of event outcomes (i.e. each pair of “YES” + “NO” shares) is fully collateralized by $1.00 USDC

  • Shares are created when the sum of what each side is willing to pay is equal to $1.00 opposing sides come to an agreement on odds

  • The shares representing the correct, final outcome are paid out $1.00 USDC each upon market resolution

  • Unlike sportsbooks, you are not betting against “the house” – the counterparty to each trade is another Polymarket user. As such:

    • Shares can be sold before the event outcome is known (i.e. to lock in profits or cut losses).

    • There is no “house” to ban you for winning too much.

​Understanding Prices

Prices = Probabilities.

Prices (odds) on Polymarket represent the current probability of an event occurring. For example, in a market predicting whether the Miami Heat will win the 2025 NBA Finals, if YES shares are trading at 18 cents, it indicates a 18% chance of Miami winning.

These odds are determined by what price other Polymarket users are currently willing to buy & sell those shares at. Just how stock exchanges don’t “set” the prices of stocks, Polymarket does not set prices / odds - they’re a function of supply & demand.

​Making money on markets

In the example above, if you believe Miami’s chances of winning are higher than 18%, you would buy “Yes” shares at 18 cents each. If Miami wins, each “Yes” share would be worth $1, resulting in an 82-cent profit per share. Conversely, any trader who owned “No” shares would see their investment become worthless once the game is over.

Since it’s a market, you’re not locked into your trade. You can sell your shares at any time at the current market price. As the news changes, the supply and demand for shares fluctuates, causing the share price to reflect the new odds for the event.

​How accurate are Polymarket odds?

Research shows prediction markets are often more accurate than experts, polls, and pundits. Traders aggregate news, polls, and expert opinions, making informed trades. Their economic incentives ensure market prices adjust to reflect true odds as more knowledgeable participants join.

This makes prediction markets the best source of real-time event probabilities. People use Polymarket for the most accurate odds, gaining the ability to make informed decisions about the future.

If you’re an expert on a certain topic, Polymarket is your opportunity to profit from trading based on your knowledge, while improving the market’s accuracy.

Related Articles
Polymarket vs. Polling
Why Crypto?
What is a Prediction Market?
How Are Prices Calculated?
What are Combos?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

What is Polymarket

Polymarket is the world’s largest prediction market, allowing you to stay informed and profit from your knowledge by betting on future events across various topics.

Studies show prediction markets are often more accurate than pundits because they combine news, polls, and expert opinions into a single value that represents the market’s view of an event’s odds. Our markets reflect accurate, unbiased, and real-time probabilities for the events that matter most to you. Markets seek truth.

​Quick Overview

  • On Polymarket, you can trade on future event outcomes (i.e. “Will TikTok be banned in the U.S. this year?”)

  • Shares in event outcomes are between 0.00 and 1.00, and every pair of event outcomes (i.e. each pair of “YES” + “NO” shares) is fully collateralized by $1.00 USDC

  • Shares are created when the sum of what each side is willing to pay is equal to $1.00 opposing sides come to an agreement on odds

  • The shares representing the correct, final outcome are paid out $1.00 USDC each upon market resolution

  • Unlike sportsbooks, you are not betting against “the house” – the counterparty to each trade is another Polymarket user. As such:

    • Shares can be sold before the event outcome is known (i.e. to lock in profits or cut losses).

    • There is no “house” to ban you for winning too much.

​Understanding Prices

Prices = Probabilities.

Prices (odds) on Polymarket represent the current probability of an event occurring. For example, in a market predicting whether the Miami Heat will win the 2025 NBA Finals, if YES shares are trading at 18 cents, it indicates a 18% chance of Miami winning.

These odds are determined by what price other Polymarket users are currently willing to buy & sell those shares at. Just how stock exchanges don’t “set” the prices of stocks, Polymarket does not set prices / odds - they’re a function of supply & demand.

​Making money on markets

In the example above, if you believe Miami’s chances of winning are higher than 18%, you would buy “Yes” shares at 18 cents each. If Miami wins, each “Yes” share would be worth $1, resulting in an 82-cent profit per share. Conversely, any trader who owned “No” shares would see their investment become worthless once the game is over.

Since it’s a market, you’re not locked into your trade. You can sell your shares at any time at the current market price. As the news changes, the supply and demand for shares fluctuates, causing the share price to reflect the new odds for the event.

​How accurate are Polymarket odds?

Research shows prediction markets are often more accurate than experts, polls, and pundits. Traders aggregate news, polls, and expert opinions, making informed trades. Their economic incentives ensure market prices adjust to reflect true odds as more knowledgeable participants join.

This makes prediction markets the best source of real-time event probabilities. People use Polymarket for the most accurate odds, gaining the ability to make informed decisions about the future.

If you’re an expert on a certain topic, Polymarket is your opportunity to profit from trading based on your knowledge, while improving the market’s accuracy.

Related Articles
Polymarket vs. Polling
Why Crypto?
What is a Prediction Market?
How Are Prices Calculated?
What are Combos?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/markets/dispute.md b/docs/polymarket-learn/markets/dispute.md index f51a817..9c2ac57 100644 --- a/docs/polymarket-learn/markets/dispute.md +++ b/docs/polymarket-learn/markets/dispute.md @@ -1,4 +1,4 @@ -How Are Markets Disputed? | Polymarket Help Center
Skip to main content

How Are Markets Disputed?

Anyone can dispute a proposed market resolution if they feel it was proposed in error.

Once a market is proposed for resolution it goes into a challenge period of 2 hours.

If no one challenges the proposal during the 2-hour period, then the resolution is deemed valid and the proposer receives their bond back plus the reward.

During the 2-hour challenge period, anyone may dispute the proposal on the UMA dapp by posting a challenge bond of the same amount as the proposer bond (usually $750).

The dispute link can be found in the "Rules" section of the market page.

This begins the debate period of 24-48 hours (votes happen every other day and there will always be at least 24 hours for discussion). Anyone wishing to contribute evidence to the discussion can do so in the Uma Discord server in the #evidence-rationale and #voting-discussion channels.

After the debate period, Uma token holders vote (this process takes approximately 48 hours) and one of four outcomes happens:

​Proposer wins

Proposer receives their bond back plus half the disputer’s bond as a bounty. Disputer loses their bond.

​Disputer wins

Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.

​Too Early

This outcome is for proposals for which the underlying event has not yet happened. Eg the result of a sports match that is still ongoing. Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.

​Unknown/50-50

This (rarely used) outcome is for events where none of the other options are appropriate. In this case the market price resolves to 50 yes and 50 no. Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.

Polymarket is non-custodial and cannot alter or reverse market resolutions. Once finalized by UMA, outcomes are immutable.

For additional context:

UMA is a decentralized third-party oracle, who governs this process to ensure fairness and transparency. Reviewing the market rules is essential to understand how a specific market will resolve.

Related Articles
How Are Prediction Markets Resolved?
Sponsor Market Rewards
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How Are Markets Disputed?

Anyone can dispute a proposed market resolution if they feel it was proposed in error.

Once a market is proposed for resolution it goes into a challenge period of 2 hours.

If no one challenges the proposal during the 2-hour period, then the resolution is deemed valid and the proposer receives their bond back plus the reward.

During the 2-hour challenge period, anyone may dispute the proposal on the UMA dapp by posting a challenge bond of the same amount as the proposer bond (usually $750).

The dispute link can be found in the "Rules" section of the market page.

This begins the debate period of 24-48 hours (votes happen every other day and there will always be at least 24 hours for discussion). Anyone wishing to contribute evidence to the discussion can do so in the Uma Discord server in the #evidence-rationale and #voting-discussion channels.

After the debate period, Uma token holders vote (this process takes approximately 48 hours) and one of four outcomes happens:

​Proposer wins

Proposer receives their bond back plus half the disputer’s bond as a bounty. Disputer loses their bond.

​Disputer wins

Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.

​Too Early

This outcome is for proposals for which the underlying event has not yet happened. Eg the result of a sports match that is still ongoing. Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.

​Unknown/50-50

This (rarely used) outcome is for events where none of the other options are appropriate. In this case the market price resolves to 50 yes and 50 no. Disputer receives their bond back plus half the proposer’s bond as a bounty. Proposer loses their bond.

Polymarket is non-custodial and cannot alter or reverse market resolutions. Once finalized by UMA, outcomes are immutable.

For additional context:

UMA is a decentralized third-party oracle, who governs this process to ensure fairness and transparency. Reviewing the market rules is essential to understand how a specific market will resolve.

Related Articles
How Are Prediction Markets Resolved?
Sponsor Market Rewards
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/markets/how-are-markets-clarified.md b/docs/polymarket-learn/markets/how-are-markets-clarified.md index c596b84..360842f 100644 --- a/docs/polymarket-learn/markets/how-are-markets-clarified.md +++ b/docs/polymarket-learn/markets/how-are-markets-clarified.md @@ -1,4 +1,4 @@ -How Are Markets Clarified? | Polymarket Help Center
Skip to main content

How Are Markets Clarified?

How are markets on Polymarket clarified?

​Overview

  • Markets are resolved according to the rules set forth on the market page.

  • The rules specify the resolution source, the market end date, and they outline how the market should resolve in various edge-cases.

  • The market title describes the market, but the rules define how it should be resolved.

  • When a market is clarified, the order book is cleared and all resting orders cancelled at the time of clarification. If a clarification is announced in advance, the order book is also cleared at the time of the announcement

Related Articles
Limit Orders
Liquidity Rewards
How Are Prediction Markets Resolved?
How Are Markets Disputed?
Polymarket Exchange Upgrade: April 28, 2026
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How Are Markets Clarified?

How are markets on Polymarket clarified?

​Overview

  • Markets are resolved according to the rules set forth on the market page.

  • The rules specify the resolution source, the market end date, and they outline how the market should resolve in various edge-cases.

  • The market title describes the market, but the rules define how it should be resolved.

  • When a market is clarified, the order book is cleared and all resting orders cancelled at the time of clarification. If a clarification is announced in advance, the order book is also cleared at the time of the announcement

Related Articles
Limit Orders
Liquidity Rewards
How Are Prediction Markets Resolved?
How Are Markets Disputed?
Polymarket Exchange Upgrade: April 28, 2026
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/markets/how-are-markets-created.md b/docs/polymarket-learn/markets/how-are-markets-created.md index d5dc642..b0811ba 100644 --- a/docs/polymarket-learn/markets/how-are-markets-created.md +++ b/docs/polymarket-learn/markets/how-are-markets-created.md @@ -1,4 +1,4 @@ -How Are Markets Created? | Polymarket Help Center
Skip to main content

How Are Markets Created?

Markets are created by the markets team with input from users and the community.


Can I create my own market?

While users cannot directly create their own markets, they are encouraged to suggest ideas for new markets.

​Submit your market proposal

To give your proposal the best chance of being listed, include as much information as possible, such as:

  • What is the market title?

  • What is the resolution source?

  • Evidence of demand for trading that market

The best ways to propose a new market are:

  • On Twitter / X by tagging @polymarket

Related Articles
What is Polymarket
What is a Prediction Market?
How Are Prediction Markets Resolved?
How Are Markets Disputed?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How Are Markets Created?

Markets are created by the markets team with input from users and the community.


Can I create my own market?

While users cannot directly create their own markets, they are encouraged to suggest ideas for new markets.

​Submit your market proposal

To give your proposal the best chance of being listed, include as much information as possible, such as:

  • What is the market title?

  • What is the resolution source?

  • Evidence of demand for trading that market

The best ways to propose a new market are:

  • On Twitter / X by tagging @polymarket

Related Articles
What is Polymarket
What is a Prediction Market?
How Are Prediction Markets Resolved?
How Are Markets Disputed?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/markets/how-are-markets-resolved.md b/docs/polymarket-learn/markets/how-are-markets-resolved.md index 5fb340b..14b4f51 100644 --- a/docs/polymarket-learn/markets/how-are-markets-resolved.md +++ b/docs/polymarket-learn/markets/how-are-markets-resolved.md @@ -1,4 +1,4 @@ -How Are Prediction Markets Resolved? | Polymarket Help Center
Skip to main content

How Are Prediction Markets Resolved?

Markets are resolved by the UMA Optimistic Oracle, a smart-contract based optimistic oracle.

Overview

  • When the result of a market becomes clear, the market can be “resolved,” or permanently finalized.

  • Markets are resolved according to the market’s pre-defined rules, which can be found under market’s the order book.

  • When a market is resolved, holders of winning shares receive $1 per share, losing shares become worthless, and trading of shares is no longer possible.

  • To resolve a market, an outcome must first be “proposed,” which involves putting up a bond in USDC.e which will be forfeited if the proposal is unsuccessful.

  • If the proposal is validated as accurate, the proposer will receive a reward for your proposal.

If you propose a market too early, or are unsuccessful in your proposal, you will lose all of your $750 bond. Do not propose a resolution unless you understand the process and are confident in your view.

To propose a market resolution

Once in the verification process, UMA will review the transaction to ensure it was proposed correctly. If approved, you will receive your bond amount back in your wallet plus the reward. If not approved, it will enter Uma’s dispute resolution process, which is described in detail here.

​To dispute a proposed resolution

Once a market is proposed for resolution it goes into a challenge period of 2 hours.

If you do not agree with a proposed resolution, you can dispute the outcome.

Related Articles
What is a Prediction Market?
How Are Markets Created?
How Are Markets Clarified?
How Are Markets Disputed?
Sponsor Market Rewards
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How Are Prediction Markets Resolved?

Markets are resolved by the UMA Optimistic Oracle, a smart-contract based optimistic oracle.

Overview

  • When the result of a market becomes clear, the market can be “resolved,” or permanently finalized.

  • Markets are resolved according to the market’s pre-defined rules, which can be found under market’s the order book.

  • When a market is resolved, holders of winning shares receive $1 per share, losing shares become worthless, and trading of shares is no longer possible.

  • To resolve a market, an outcome must first be “proposed,” which involves putting up a bond in USDC.e which will be forfeited if the proposal is unsuccessful.

  • If the proposal is validated as accurate, the proposer will receive a reward for your proposal.

If you propose a market too early, or are unsuccessful in your proposal, you will lose all of your $750 bond. Do not propose a resolution unless you understand the process and are confident in your view.

To propose a market resolution

Once in the verification process, UMA will review the transaction to ensure it was proposed correctly. If approved, you will receive your bond amount back in your wallet plus the reward. If not approved, it will enter Uma’s dispute resolution process, which is described in detail here.

​To dispute a proposed resolution

Once a market is proposed for resolution it goes into a challenge period of 2 hours.

If you do not agree with a proposed resolution, you can dispute the outcome.

Related Articles
What is a Prediction Market?
How Are Markets Created?
How Are Markets Clarified?
How Are Markets Disputed?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/trading/holding-rewards.md b/docs/polymarket-learn/trading/holding-rewards.md index 9fd0ade..6ac66ed 100644 --- a/docs/polymarket-learn/trading/holding-rewards.md +++ b/docs/polymarket-learn/trading/holding-rewards.md @@ -1,4 +1,4 @@ -Holding Rewards | Polymarket Help Center
Skip to main content

Holding Rewards

Earn rewards on eligible positions while helping maintain long-term market pricing accuracy

What are we doing?

To keep long-term pricing accurate, we’re paying 3.25% 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 3.25% 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 the time of sampling:

  • 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 3.25% Annual Reward):

  • $20400 × (0.0325 / 365 / 24) ≈ $0.075697

​Eligible Events:

Related Articles
Sponsor Market Rewards
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

Holding Rewards

Earn rewards on eligible positions while helping maintain long-term market pricing accuracy

What are we doing?

To keep long-term pricing accurate, we’re paying 3.25% 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 3.25% 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 the time of sampling:

  • 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 3.25% Annual Reward):

  • $20400 × (0.0325 / 365 / 24) ≈ $0.075697

​Eligible Events:

Related Articles
Sponsor Market Rewards
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/trading/how-are-prices-calculated.md b/docs/polymarket-learn/trading/how-are-prices-calculated.md index 13f8040..be91dac 100644 --- a/docs/polymarket-learn/trading/how-are-prices-calculated.md +++ b/docs/polymarket-learn/trading/how-are-prices-calculated.md @@ -1,4 +1,4 @@ -How Are Prices Calculated? | Polymarket Help Center
Skip to main content

How Are Prices Calculated?

The prices probabilities displayed on Polymarket are the midpoint of the bid-ask spread in the orderbook.


Initial Price

  • When a market is created, there are initially zero shares and no pre-defined prices or odds.

  • Market makers (a fancy term for traders placing limit orders) interested in buying YES or NO shares can place Limit Orders at the price they’re willing to pay

  • When offers for the YES and NO side equal $1.00, the order is “matched” and that $1.00 is converted into 1 YES and 1 NO share, each going to their respective buyers.

For example, if you place a limit order at $0.60 for YES, that order is matched when someone places a NO order at $0.40.This becomes the initial market price.

​Future Price

The prices displayed on Polymarket are the midpoint of the bid-ask spread in the orderbook — unless that spread is over $0.10, in which case the last traded price is used.Like the stock market, prices on Polymarket are a function of realtime supply & demand.

​Prices = Probabilities

In the market below, the probability of 37% is the midpoint between the 34¢ bid and 40¢ ask. If the bid-ask spread is wider than 10¢, the probability is shown as the last traded price.

To see how accurate Polymarket's prices have been historically, visit the Accuracy page.

Related Articles
What is Polymarket
Liquidity Rewards
Maker Rebates Program
Trading Fees
What are Combos?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

How Are Prices Calculated?

The prices probabilities displayed on Polymarket are the midpoint of the bid-ask spread in the orderbook.


Initial Price

  • When a market is created, there are initially zero shares and no pre-defined prices or odds.

  • Market makers (a fancy term for traders placing limit orders) interested in buying YES or NO shares can place Limit Orders at the price they’re willing to pay

  • When offers for the YES and NO side equal $1.00, the order is “matched” and that $1.00 is converted into 1 YES and 1 NO share, each going to their respective buyers.

For example, if you place a limit order at $0.60 for YES, that order is matched when someone places a NO order at $0.40.This becomes the initial market price.

​Future Price

The prices displayed on Polymarket are the midpoint of the bid-ask spread in the orderbook — unless that spread is over $0.10, in which case the last traded price is used.Like the stock market, prices on Polymarket are a function of realtime supply & demand.

​Prices = Probabilities

In the market below, the probability of 37% is the midpoint between the 34¢ bid and 40¢ ask. If the bid-ask spread is wider than 10¢, the probability is shown as the last traded price.

To see how accurate Polymarket's prices have been historically, visit the Accuracy page.

Related Articles
What is Polymarket
Liquidity Rewards
Maker Rebates Program
Trading Fees
What are Combos?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/trading/limit-orders.md b/docs/polymarket-learn/trading/limit-orders.md index 30c9cab..41006c6 100644 --- a/docs/polymarket-learn/trading/limit-orders.md +++ b/docs/polymarket-learn/trading/limit-orders.md @@ -1,4 +1,4 @@ -Limit Orders | Polymarket Help Center
Skip to main content

Limit Orders

What are limit orders and how to make them.

What are Limit Orders?

Limit orders are open orders (pending trades) that only execute when the market trades at your desired price.

For example, if the highest you’re willing to pay for a share of Trump “Yes” in the 2024 Republican Nomination is 72c, but the current market price is 73c, you could create a limit order at 72c and wait until someone is willing to sell Yes shares at your desired price.

It’s not necessary for the entire order to execute at once. Limit orders can ‘partially fill’ as individual traders fill parts of your order.

​Managing limit orders

When you have an open order, you’ll find it displayed just below the Order Book on the market’s page.If you have open orders across multiple markets, you can easily manage and monitor them all from the Portfolio page.
​

Specifically for sports markets, any outstanding limit orders are automatically cancelled once the game begins, clearing the entire order book at the official start time. Be aware, game start times can shift so it’s important to always monitor your orders closely in case they are not cleared due to game changes or other circumstances.

Additionally, sports markets include a 3-second delay on the placement of marketable orders.

A 1-second taker delay is currently being tested on NBA and MLB markets, with others being added in the future.

​Canceling limit orders

When you have an open order, you’ll find it displayed just below the Order Book on the market’s page.To cancel the order, you can simply click the red x button alongside the order.

If you have open orders across multiple markets, you can easily manage and monitor them all from the Portfolio page.

Nice! You can officially call yourself an advanced trader.

If some of this still isn’t making sense, feel free to reach out to us on Discord. We’re happy to help get you up to speed

Related Articles
Liquidity Rewards
Maker Rebates Program
How Are Prices Calculated?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

Limit Orders

What are limit orders and how to make them.

What are Limit Orders?

Limit orders are open orders (pending trades) that only execute when the market trades at your desired price.

For example, if the highest you’re willing to pay for a share of Trump “Yes” in the 2024 Republican Nomination is 72c, but the current market price is 73c, you could create a limit order at 72c and wait until someone is willing to sell Yes shares at your desired price.

It’s not necessary for the entire order to execute at once. Limit orders can ‘partially fill’ as individual traders fill parts of your order.

​Managing limit orders

When you have an open order, you’ll find it displayed just below the Order Book on the market’s page.If you have open orders across multiple markets, you can easily manage and monitor them all from the Portfolio page.
​

Specifically for sports markets, any outstanding limit orders are automatically cancelled once the game begins, clearing the entire order book at the official start time. Be aware, game start times can shift so it’s important to always monitor your orders closely in case they are not cleared due to game changes or other circumstances.

Additionally, sports markets include a 3-second delay on the placement of marketable orders.

A 1-second taker delay is currently being tested on NBA and MLB markets, with others being added in the future.

​Canceling limit orders

When you have an open order, you’ll find it displayed just below the Order Book on the market’s page.To cancel the order, you can simply click the red x button alongside the order.

If you have open orders across multiple markets, you can easily manage and monitor them all from the Portfolio page.

Nice! You can officially call yourself an advanced trader.

If some of this still isn’t making sense, feel free to reach out to us on Discord. We’re happy to help get you up to speed

Related Articles
How Are Prices Calculated?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/trading/liquidity-rewards.md b/docs/polymarket-learn/trading/liquidity-rewards.md index d1a2e85..b50dccd 100644 --- a/docs/polymarket-learn/trading/liquidity-rewards.md +++ b/docs/polymarket-learn/trading/liquidity-rewards.md @@ -1,4 +1,4 @@ -Liquidity Rewards | Polymarket Help Center
Skip to main content

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 reward page to check your current earnings for the day, which markets have rewards in place, as well as how much.

  • Rewards are tallied per day. A day only pays out if your earnings for that day reach $1. If a day's earnings are below $1, they are not paid, and they do not roll over or add to any other day. Each day stands on its own.

Simply put, the more you help the market by placing good orders, the more rewards you earn!

Example

Earn $0.40 on Monday and $0.40 on Tuesday and neither day pays, the two days are not combined. Earn $1.20 on Wednesday and you're paid $1.20 at the next midnight UTC.

​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 for the previous day's earnings, provided that day reached the $1 minimum. The earnings figure on your rewards page shows what you've generated for the current day, it is a daily total, not a running balance that accumulates toward a future payout. Your portfolio history reflects rewards actually paid to your address.

Related Articles
Holding Rewards
Maker Rebates Program
How Are Prices Calculated?
Sponsor Market Rewards
Referral Program
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

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 reward page to check your current earnings for the day, which markets have rewards in place, as well as how much.

  • Rewards are tallied per day. A day only pays out if your earnings for that day reach $1. If a day's earnings are below $1, they are not paid, and they do not roll over or add to any other day. Each day stands on its own.

Simply put, the more you help the market by placing good orders, the more rewards you earn!

Example

Earn $0.40 on Monday and $0.40 on Tuesday and neither day pays, the two days are not combined. Earn $1.20 on Wednesday and you're paid $1.20 at the next midnight UTC.

​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 for the previous day's earnings, provided that day reached the $1 minimum. The earnings figure on your rewards page shows what you've generated for the current day, it is a daily total, not a running balance that accumulates toward a future payout. Your portfolio history reflects rewards actually paid to your address.

Related Articles
Holding Rewards
Maker Rebates Program
How Are Prices Calculated?
Sponsor Market Rewards
Referral Program
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/polymarket-learn/trading/market-orders.md b/docs/polymarket-learn/trading/market-orders.md index 6041c77..7b25901 100644 --- a/docs/polymarket-learn/trading/market-orders.md +++ b/docs/polymarket-learn/trading/market-orders.md @@ -208,7 +208,7 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even .size(dec!(10)) .side(Side::Buy) .order_type(OrderType::GTD) - .expiration(Utc::now() + TimeDelta::hours(1)) + .expiration(Utc::now() + TimeDelta::minutes(1) + TimeDelta::hours(1)) .build() .await?; let signed = client.sign(&signer, order).await?; @@ -217,9 +217,11 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even - There is a security threshold of one minute on GTD expiration. To set an - effective lifetime of N seconds, use `now + 60 + N`. For example, for a - 30-second effective lifetime, set the expiration to `now + 60 + 30`. + GTD orders expire one minute before their stated expiration as a security + threshold. To set an effective lifetime of N seconds, use `now + 60 + N`. + In addition, the expiration must be at least three minutes in the future — + orders expiring sooner are rejected — so the minimum effective lifetime is + about two minutes. *** diff --git a/docs/polymarket-learn/trading/no-limits.md b/docs/polymarket-learn/trading/no-limits.md index 9ade98e..4601a55 100644 --- a/docs/polymarket-learn/trading/no-limits.md +++ b/docs/polymarket-learn/trading/no-limits.md @@ -1,4 +1,4 @@ -Does Polymarket Have Trading Limits? | Polymarket Help Center
Skip to main content

Does Polymarket Have Trading Limits?

By design, the Polymarket orderbook does not have trading size limits. It matches willing buyers and sellers of any amount.

However, there is no guarantee that it will be possible to transact a desired amount of shares without impacting the price significantly, or at all if there are no willing counterparties.

Before trading in any market, especially in large size, it is valuable to look at the orderbook to understand depth of liquidity, ie how many buyers or sellers are in the market and their desired trade size and price.


​

Related Articles
What are Combos?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file +--text-on-primary-color: #ffffff}
Skip to main content

Does Polymarket Have Trading Limits?

By design, the Polymarket orderbook does not have trading size limits. It matches willing buyers and sellers of any amount.

However, there is no guarantee that it will be possible to transact a desired amount of shares without impacting the price significantly, or at all if there are no willing counterparties.

Before trading in any market, especially in large size, it is valuable to look at the orderbook to understand depth of liquidity, ie how many buyers or sellers are in the market and their desired trade size and price.


​

Related Articles
What are Combos?
Did this answer your question?
Polymarket Help Center
\ No newline at end of file diff --git a/docs/resources/error-codes.md b/docs/resources/error-codes.md index 9c6b407..d9cefaf 100644 --- a/docs/resources/error-codes.md +++ b/docs/resources/error-codes.md @@ -271,6 +271,10 @@ These errors are returned when an order passes initial validation but fails duri `the market is not yet ready to process new orders` + + `order timed out` — The exchange could not process the order before the request deadline. This typically happens during bursts of concurrent order submissions from the same account. The order was rejected before reaching the order book and can be safely resubmitted. + + *** ## Matching Engine Errors