From 88de1ab5cdf9eb98ddb592518954957bbf16378b Mon Sep 17 00:00:00 2001 From: Etherdrake Date: Mon, 4 May 2026 14:56:14 +0200 Subject: [PATCH] docs: sync Polymarket documentation (2026-05-04) --- docs/api-reference/authentication.md | 51 +++++++----- docs/api-reference/clients-sdks.md | 12 +-- docs/changelog/changelog.md | 12 +-- docs/index.md | 14 ++-- .../FAQ/does-polymarket-have-an-api.md | 4 +- docs/polymarket-learn/FAQ/embeds.md | 4 +- docs/polymarket-learn/FAQ/geoblocking.md | 4 +- .../FAQ/how-to-export-private-key.md | 4 +- docs/polymarket-learn/FAQ/is-my-money-safe.md | 4 +- .../FAQ/is-polymarket-the-house.md | 4 +- docs/polymarket-learn/FAQ/polling.md | 4 +- .../FAQ/recover-missing-deposit.md | 4 +- docs/polymarket-learn/FAQ/sell-early.md | 4 +- docs/polymarket-learn/FAQ/support.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 | 82 +++++++++---------- .../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 | 82 +++++++++---------- docs/polymarket-learn/trading/no-limits.md | 4 +- 35 files changed, 189 insertions(+), 180 deletions(-) diff --git a/docs/api-reference/authentication.md b/docs/api-reference/authentication.md index 2761c5c..227d611 100644 --- a/docs/api-reference/authentication.md +++ b/docs/api-reference/authentication.md @@ -63,12 +63,16 @@ Before making authenticated requests, you need to obtain API credentials using L ```typescript theme={null} import { ClobClient } from "@polymarket/clob-client-v2"; - import { Wallet } from "ethers"; // v5.8.0 + import { createWalletClient, http } from "viem"; + import { privateKeyToAccount } from "viem/accounts"; + + const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`); + const signer = createWalletClient({ account, transport: http() }); const client = new ClobClient({ host: "https://clob.polymarket.com", chain: 137, // Polygon mainnet - signer: new Wallet(process.env.PRIVATE_KEY), + signer, }); // Creates new credentials or derives existing ones @@ -76,7 +80,7 @@ Before making authenticated requests, you need to obtain API credentials using L console.log(credentials); // { - // apiKey: "550e8400-e29b-41d4-a716-446655440000", + // key: "550e8400-e29b-41d4-a716-446655440000", // secret: "base64EncodedSecretString", // passphrase: "randomPassphraseString" // } @@ -85,17 +89,17 @@ Before making authenticated requests, you need to obtain API credentials using L ```python theme={null} - from py_clob_client.client import ClobClient + from py_clob_client_v2 import ClobClient import os client = ClobClient( host="https://clob.polymarket.com", - chain=137, # Polygon mainnet + chain_id=137, # Polygon mainnet key=os.getenv("PRIVATE_KEY") ) # Creates new credentials or derives existing ones - credentials = client.create_or_derive_api_creds() + credentials = client.create_or_derive_api_key() print(credentials) # { @@ -109,9 +113,9 @@ Before making authenticated requests, you need to obtain API credentials using L ```rust theme={null} use std::str::FromStr; - use polymarket_client_sdk::POLYGON; - use polymarket_client_sdk::auth::{LocalSigner, Signer}; - use polymarket_client_sdk::clob::{Client, Config}; + use polymarket_client_sdk_v2::POLYGON; + use polymarket_client_sdk_v2::auth::{LocalSigner, Signer}; + use polymarket_client_sdk_v2::clob::{Client, Config}; let private_key = std::env::var("POLYMARKET_PRIVATE_KEY")?; let signer = LocalSigner::from_str(&private_key)? @@ -221,7 +225,7 @@ The `POLY_SIGNATURE` is generated by signing the following EIP-712 struct: Reference implementations: * [TypeScript](https://github.com/Polymarket/clob-client-v2/blob/main/src/signing/eip712.ts) -* [Python](https://github.com/Polymarket/py-clob-client-v2/blob/main/py_clob_client/signing/eip712.py) +* [Python](https://github.com/Polymarket/py-clob-client-v2/blob/main/py_clob_client_v2/signing/eip712.py) Response: @@ -249,20 +253,24 @@ All trading endpoints require these 5 headers: | `POLY_API_KEY` | User's API `apiKey` value | | `POLY_PASSPHRASE` | User's API `passphrase` value | -The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's API credentials `secret` value. Reference implementations can be found in the [TypeScript](https://github.com/Polymarket/clob-client-v2/blob/main/src/signing/hmac.ts) and [Python](https://github.com/Polymarket/py-clob-client-v2/blob/main/py_clob_client/signing/hmac.py) clients. +The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's API credentials `secret` value. Reference implementations can be found in the [TypeScript](https://github.com/Polymarket/clob-client-v2/blob/main/src/signing/hmac.ts) and [Python](https://github.com/Polymarket/py-clob-client-v2/blob/main/py_clob_client_v2/signing/hmac.py) clients. ### CLOB Client ```typescript theme={null} - import { ClobClient } from "@polymarket/clob-client-v2"; - import { Wallet } from "ethers"; // v5.8.0 + import { ClobClient, Side } from "@polymarket/clob-client-v2"; + import { createWalletClient, http } from "viem"; + import { privateKeyToAccount } from "viem/accounts"; + + const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`); + const signer = createWalletClient({ account, transport: http() }); const client = new ClobClient({ host: "https://clob.polymarket.com", chain: 137, - signer: new Wallet(process.env.PRIVATE_KEY), + signer, creds: apiCreds, // Generated from L1 auth, API credentials enable L2 methods signatureType: 1, // signatureType explained below funderAddress, // funder explained below @@ -270,7 +278,7 @@ The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's // Now you can trade! const order = await client.createAndPostOrder( - { tokenID: "123456", price: 0.65, size: 100, side: "BUY" }, + { tokenID: "123456", price: 0.65, size: 100, side: Side.BUY }, { tickSize: "0.01", negRisk: false } ); ``` @@ -278,12 +286,13 @@ The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's ```python theme={null} - from py_clob_client.client import ClobClient + from py_clob_client_v2 import ClobClient, OrderArgs, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY import os client = ClobClient( host="https://clob.polymarket.com", - chain=137, + chain_id=137, key=os.getenv("PRIVATE_KEY"), creds=api_creds, # Generated from L1 auth, API credentials enable L2 methods signature_type=1, # signatureType explained below @@ -292,16 +301,16 @@ The `POLY_SIGNATURE` for L2 is an HMAC-SHA256 signature created using the user's # Now you can trade! order = client.create_and_post_order( - {"token_id": "123456", "price": 0.65, "size": 100, "side": "BUY"}, - {"tick_size": "0.01", "neg_risk": False} + OrderArgs(token_id="123456", price=0.65, size=100, side=BUY), + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), ) ``` ```rust theme={null} - use polymarket_client_sdk::clob::types::{Side, SignatureType}; - use polymarket_client_sdk::types::dec; + use polymarket_client_sdk_v2::clob::types::{Side, SignatureType}; + use polymarket_client_sdk_v2::types::dec; let client = Client::new("https://clob.polymarket.com", Config::default())? .authentication_builder(&signer) diff --git a/docs/api-reference/clients-sdks.md b/docs/api-reference/clients-sdks.md index 5656870..8134da4 100644 --- a/docs/api-reference/clients-sdks.md +++ b/docs/api-reference/clients-sdks.md @@ -12,7 +12,7 @@ Polymarket provides official open-source clients in TypeScript, Python, and Rust ```bash TypeScript theme={null} - npm install @polymarket/clob-client-v2 ethers@5 + npm install @polymarket/clob-client-v2 viem ``` ```bash Python theme={null} @@ -20,7 +20,7 @@ Polymarket provides official open-source clients in TypeScript, Python, and Rust ``` ```bash Rust theme={null} - cargo add polymarket-client-sdk + cargo add polymarket_client_sdk_v2 --features clob ``` @@ -41,12 +41,12 @@ Polymarket provides official open-source clients in TypeScript, Python, and Rust ``` ```python Python theme={null} - from py_clob_client.client import ClobClient + from py_clob_client_v2 import ClobClient client = ClobClient( "https://clob.polymarket.com", key=private_key, - chain=137, + chain_id=137, creds=api_creds, ) @@ -54,7 +54,7 @@ Polymarket provides official open-source clients in TypeScript, Python, and Rust ``` ```rust Rust theme={null} - use polymarket_client_sdk::clob::{Client, Config}; + use polymarket_client_sdk_v2::clob::{Client, Config}; let client = Client::new("https://clob.polymarket.com", Config::default())? .authentication_builder(&signer) @@ -71,7 +71,7 @@ Polymarket provides official open-source clients in TypeScript, Python, and Rust | ---------- | ---------------------------- | ------------------------------------------------------------------------------------------ | | TypeScript | `@polymarket/clob-client-v2` | [github.com/Polymarket/clob-client-v2](https://github.com/Polymarket/clob-client-v2) | | Python | `py-clob-client-v2` | [github.com/Polymarket/py-clob-client-v2](https://github.com/Polymarket/py-clob-client-v2) | -| Rust | `polymarket-client-sdk` | [github.com/Polymarket/rs-clob-client-v2](https://github.com/Polymarket/rs-clob-client-v2) | +| Rust | `polymarket_client_sdk_v2` | [github.com/Polymarket/rs-clob-client-v2](https://github.com/Polymarket/rs-clob-client-v2) | Each repository includes working examples in the `/examples` directory. diff --git a/docs/changelog/changelog.md b/docs/changelog/changelog.md index 82e9f6b..80054d2 100644 --- a/docs/changelog/changelog.md +++ b/docs/changelog/changelog.md @@ -166,7 +166,7 @@ - * We're adding new fields to the `get-book` and `get-books` CLOB endpoints to include key market metadata that previously required separate queries. + * We’re adding new fields to the `get-book` and `get-books` CLOB endpoints to include key market metadata that previously required separate queries. * `min_order_size` * type: string * description: Minimum price increment. @@ -179,7 +179,7 @@ - * We're excited to roll out a highly requested feature: **order batching**. With this new endpoint, users can now submit up to five trades in a single request. To help you get started, we've included sample code demonstrating how to use it. Please see [Create Orders](/trading/orders/create) for more details. + * We’re excited to roll out a highly requested feature: **order batching**. With this new endpoint, users can now submit up to five trades in a single request. To help you get started, we’ve included sample code demonstrating how to use it. Please see [Create Orders](/trading/orders/create) for more details. @@ -194,7 +194,7 @@ - We're excited to introduce a new order type soon to be available to all users: Fill and Kill (FAK). FAK orders behave similarly to the well-known Fill or Kill (FOK) orders, but with a key difference: + We’re excited to introduce a new order type soon to be available to all users: Fill and Kill (FAK). FAK orders behave similarly to the well-known Fill or Kill (FOK) orders, but with a key difference: * FAK will fill as many shares as possible immediately at your specified price, and any remaining unfilled portion will be canceled. * Unlike FOK, which requires the entire order to fill instantly or be canceled, FAK is more flexible and aims to capture partial fills if possible. @@ -208,7 +208,7 @@ * CLOB - /price (100req - 10s / Throttle requests over the maximum configured rate) * CLOB markets/0x (50req / 10s - Throttle requests over the maximum configured rate) * CLOB POST /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rate - * CLOB POST /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate) + * CLOB POST /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate * CLOB DELETE /order - 500 every 10s (50/s) - (BURST) - Throttle requests over the maximum configured rate - * DELETE /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate) - \ No newline at end of file + * DELETE /order - 3000 every 10 minutes (5/s) - Throttle requests over the maximum configured rate + diff --git a/docs/index.md b/docs/index.md index 4d1098e..c4440b0 100644 --- a/docs/index.md +++ b/docs/index.md @@ -78,20 +78,20 @@ export const IconCard = ({ icon, title, description, href, color }) => { ``` ```python Python theme={null} - from py_clob_client.client import ClobClient - from py_clob_client.order_builder.constants import BUY + from py_clob_client_v2 import ClobClient, OrderArgs, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY - client = ClobClient(host, key=key, chain=chain, creds=creds) + client = ClobClient(host, key=key, chain_id=chain, creds=creds) order = client.create_and_post_order( OrderArgs(token_id=token_id, price=0.50, size=10, side=BUY), - options={"tick_size": "0.01", "neg_risk": False} + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False) ) ``` ```rust Rust theme={null} - use polymarket_client_sdk::clob::{Client, Config}; - use polymarket_client_sdk::clob::types::Side; - use polymarket_client_sdk::types::dec; + use polymarket_client_sdk_v2::clob::{Client, Config}; + use polymarket_client_sdk_v2::clob::types::Side; + use polymarket_client_sdk_v2::types::dec; let client = Client::new(host, Config::default())?.authentication_builder(&signer).authenticate().await?; let order = client.limit_order().token_id(token_id).price(dec!(0.50)).size(dec!(10)).side(Side::Buy).build().await?; diff --git a/docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md b/docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md index 9a35150..3ed347c 100644 --- a/docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md +++ b/docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md @@ -1,4 +1,4 @@ -Does Polymarket have an API? | Polymarket Help Center
Skip to main content

Does Polymarket have an API?

Getting data from Polymarket

Updated over 3 months ago

Yes! Developers can find all the information they need for interacting with Polymarket. This includes documentation on market discovery, resolution, trading etc.

Whether you are an academic researcher a market maker or an indepedent developer, this documentation should provide you what you need to get started. All the code you find linked here and on our GitHub is open source and free to use.

If you have any questions please join our Discord and direct your questions to the #devs channel.

Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Does Polymarket have an API?

Getting data from Polymarket

Yes! Developers can find all the information they need for interacting with Polymarket. This includes documentation on market discovery, resolution, trading etc.

Whether you are an academic researcher a market maker or an indepedent developer, this documentation should provide you what you need to get started. All the code you find linked here and on our GitHub is open source and free to use.

If you have any questions please join our Discord and direct your questions to the #devs channel.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/embeds.md b/docs/polymarket-learn/FAQ/embeds.md index 6e98c51..805d88e 100644 --- a/docs/polymarket-learn/FAQ/embeds.md +++ b/docs/polymarket-learn/FAQ/embeds.md @@ -1,4 +1,4 @@ -How To Use Embeds | Polymarket Help Center
Skip to main content

How To Use Embeds

Adding market embeds to your Substack or website.

Updated over 3 months ago

Polymarket allows you to embed a live-updating widget displaying the latest odds for markets in many places around the web.

​Web

Navigate to the individual market you want to embed and click the embed (< >) link. Select light or dark mode, and copy the auto-generated code Paste the code into your code editor or CMS and publish as normal.

​Twitter / X

Navigate to any Polymarket market Copy the URL from your browser Paste the URL into the compose window.

​Substack

The embeds feature currently supports single markets only (eg “USA to Win Most Gold Medals”, not “Most Gold Medals at Paris Olympics’)

To embed a market, navigate on Polymarket.com to the single market you want to embed and click “copy link.”

Navigate to your Substack editor and paste the link directly into the body of your newsletter. The editor will recognize the market and convert it to a widget that automatically refreshes with the latest odds.

Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

How To Use Embeds

Adding market embeds to your Substack or website.

Polymarket allows you to embed a live-updating widget displaying the latest odds for markets in many places around the web.

​Web

Navigate to the individual market you want to embed and click the embed (< >) link. Select light or dark mode, and copy the auto-generated code Paste the code into your code editor or CMS and publish as normal.

​Twitter / X

Navigate to any Polymarket market Copy the URL from your browser Paste the URL into the compose window.

​Substack

The embeds feature currently supports single markets only (eg “USA to Win Most Gold Medals”, not “Most Gold Medals at Paris Olympics’)

To embed a market, navigate on Polymarket.com to the single market you want to embed and click “copy link.”

Navigate to your Substack editor and paste the link directly into the body of your newsletter. The editor will recognize the market and convert it to a widget that automatically refreshes with the latest odds.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/geoblocking.md b/docs/polymarket-learn/FAQ/geoblocking.md index 683cb0e..1698a47 100644 --- a/docs/polymarket-learn/FAQ/geoblocking.md +++ b/docs/polymarket-learn/FAQ/geoblocking.md @@ -167,9 +167,9 @@ The geoblocking system includes: ```rust theme={null} - use polymarket_client_sdk::clob::Client; + use polymarket_client_sdk_v2::clob::{Client, Config}; - let client = Client::default(); + let client = Client::new("https://clob.polymarket.com", Config::default())?; let geo = client.check_geoblock().await?; if geo.blocked { diff --git a/docs/polymarket-learn/FAQ/how-to-export-private-key.md b/docs/polymarket-learn/FAQ/how-to-export-private-key.md index a540050..d18d1cd 100644 --- a/docs/polymarket-learn/FAQ/how-to-export-private-key.md +++ b/docs/polymarket-learn/FAQ/how-to-export-private-key.md @@ -1,4 +1,4 @@ -How Do I Export My Key? | Polymarket Help Center
Skip to main content

How Do I Export My Key?

Exporting your private key on Magic.Link

Updated over 3 months ago

Exporting your private key gives you direct control and security over your funds. This process is applicable if you’ve signed up via email.

DO NOT share your private key with other parties, platforms, or people. We will never ask for your private key.

  1. Access the Export Link while signed into Polymarket: https://reveal.magic.link/polymarket

  2. Sign-in on Magic.Link

  3. Export Private Key. Once revealed, you should securely store the private key displayed, where others can’t access it.

  4. Log out of Magic.Link


Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

How Do I Export My Key?

Exporting your private key on Magic.Link

Exporting your private key gives you direct control and security over your funds. This process is applicable if you’ve signed up via email.

DO NOT share your private key with other parties, platforms, or people. We will never ask for your private key.

  1. Access the Export Link while signed into Polymarket: https://reveal.magic.link/polymarket

  2. Sign-in on Magic.Link

  3. Export Private Key. Once revealed, you should securely store the private key displayed, where others can’t access it.

  4. Log out of Magic.Link


Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/is-my-money-safe.md b/docs/polymarket-learn/FAQ/is-my-money-safe.md index 1fc6625..e797302 100644 --- a/docs/polymarket-learn/FAQ/is-my-money-safe.md +++ b/docs/polymarket-learn/FAQ/is-my-money-safe.md @@ -1,4 +1,4 @@ -Is My Money Safe? | Polymarket Help Center
Skip to main content

Is My Money Safe?

Yes. Polymarket is non-custodial, so you’re in control of your funds.

Updated over 3 months ago

Non-custodial, you’re in control

Polymarket recognizes the importance of a trustworthy environment for managing your funds. To ensure this, Polymarket uses non-custodial wallets, meaning we never take possession of your USDC. This approach gives you full control over your assets, providing protection against potential security threats like hacks, misuse, and unauthorized transactions.

​Your keys = your funds

A private key acts like a highly secure password, essential for managing and moving your assets without restrictions. You can export your private key at any time, ensuring sole access to your funds. Learn how to export your private key here

​Keep your private keys private.

Do not share your private key with others. While Polymarket provides the infrastructure, the security of your assets depends on how securely you handle your private key and passwords. Losing your private key or passwords can result in losing access to your funds. It’s crucial to store this information in a safe and secure environment.

​Our Commitment

Polymarket aims to give you peace of mind, knowing that your assets are safe and fully under your control at all times. We encourage you to take necessary precautions to secure your digital assets effectively. The ability to manage your private key means you are not reliant on Polymarket to secure your assets; you have the control to ensure your financial security.

Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Is My Money Safe?

Yes. Polymarket is non-custodial, so you’re in control of your funds.

Non-custodial, you’re in control

Polymarket recognizes the importance of a trustworthy environment for managing your funds. To ensure this, Polymarket uses non-custodial wallets, meaning we never take possession of your USDC. This approach gives you full control over your assets, providing protection against potential security threats like hacks, misuse, and unauthorized transactions.

​Your keys = your funds

A private key acts like a highly secure password, essential for managing and moving your assets without restrictions. You can export your private key at any time, ensuring sole access to your funds. Learn how to export your private key here

​Keep your private keys private.

Do not share your private key with others. While Polymarket provides the infrastructure, the security of your assets depends on how securely you handle your private key and passwords. Losing your private key or passwords can result in losing access to your funds. It’s crucial to store this information in a safe and secure environment.

​Our Commitment

Polymarket aims to give you peace of mind, knowing that your assets are safe and fully under your control at all times. We encourage you to take necessary precautions to secure your digital assets effectively. The ability to manage your private key means you are not reliant on Polymarket to secure your assets; you have the control to ensure your financial security.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/is-polymarket-the-house.md b/docs/polymarket-learn/FAQ/is-polymarket-the-house.md index 10e0064..496525f 100644 --- a/docs/polymarket-learn/FAQ/is-polymarket-the-house.md +++ b/docs/polymarket-learn/FAQ/is-polymarket-the-house.md @@ -1,4 +1,4 @@ -Is Polymarket The House? | Polymarket Help Center
Skip to main content

Is Polymarket The House?

No, Polymarket is not the house. All trades happen peer-to-peer (p2p).

Updated over 3 months ago

Polymarket is different in three ways:

​1. Traders interact directly with each other, not with Polymarket.

Polymarket is a marketplace comprised of traders on both sides of any given market. This means you’re always trading with other users, not against a centralized entity or “house.” Prices on Polymarket are determined by supply and demand. As traders buy and sell shares in outcomes, prices fluctuate to reflect the collective sentiment and knowledge of market participants.

​2. Polymarket does not charge trading fees.

Unlike bookmakers or wagering operations, Polymarket does not charge deposit/withdrawal fees, or any type of trading fees. This means that Polymarket does not stand to benefit from the outcome of any market or usage of any trader.

​3. Transact at any time.

Polymarket enables you to sell your position at any time before the market resolves, provided there is a willing buyer of your shares. This offers flexibility and allows you to manage your risk and lock in profits or cut losses as you see fit.

In essence, Polymarket empowers you to trade based on your own knowledge and research, without going up against a “house” with potentially unfair advantages.

Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Is Polymarket The House?

No, Polymarket is not the house. All trades happen peer-to-peer (p2p).

Polymarket is different in three ways:

​1. Traders interact directly with each other, not with Polymarket.

Polymarket is a marketplace comprised of traders on both sides of any given market. This means you’re always trading with other users, not against a centralized entity or “house.” Prices on Polymarket are determined by supply and demand. As traders buy and sell shares in outcomes, prices fluctuate to reflect the collective sentiment and knowledge of market participants.

​2. Polymarket does not charge trading fees.

Unlike bookmakers or wagering operations, Polymarket does not charge deposit/withdrawal fees, or any type of trading fees. This means that Polymarket does not stand to benefit from the outcome of any market or usage of any trader.

​3. Transact at any time.

Polymarket enables you to sell your position at any time before the market resolves, provided there is a willing buyer of your shares. This offers flexibility and allows you to manage your risk and lock in profits or cut losses as you see fit.

In essence, Polymarket empowers you to trade based on your own knowledge and research, without going up against a “house” with potentially unfair advantages.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/polling.md b/docs/polymarket-learn/FAQ/polling.md index a12c56e..129c76a 100644 --- a/docs/polymarket-learn/FAQ/polling.md +++ b/docs/polymarket-learn/FAQ/polling.md @@ -1,4 +1,4 @@ -Polymarket vs. Polling | Polymarket Help Center
Skip to main content

Polymarket vs. Polling

How is Polymarket better than traditional / legacy polling?

Updated over 3 months ago

While legacy polls capture a snapshot of opinion at a specific moment, they are often outdated by the time they’re published—sometimes lagging by several days. In contrast, Polymarket reflects real-time sentiment as events unfold, offering continuous updates and a more dynamic understanding of public opinion.

Studies show that prediction markets like Polymarket tend to outperform traditional pollsters because participants are financially incentivized to be correct. This creates more thoughtful, data-driven predictions. Research by James Surowiecki, author of The Wisdom of Crowds, has highlighted how markets like these can be more accurate than polls due to the “collective intelligence” of diverse participants. Additionally, the Iowa Electronic Markets, an academic research project at the University of Iowa, has consistently demonstrated the superior accuracy of prediction markets like Polymarket over traditional polling in predicting political outcomes.

Polymarket provides a constantly updating picture of public sentiment, offering a degree of accuracy and timeliness that traditional pollsters, who typically report data that is days old, simply cannot match.


Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Polymarket vs. Polling

How is Polymarket better than traditional / legacy polling?

While legacy polls capture a snapshot of opinion at a specific moment, they are often outdated by the time they’re published—sometimes lagging by several days. In contrast, Polymarket reflects real-time sentiment as events unfold, offering continuous updates and a more dynamic understanding of public opinion.

Studies show that prediction markets like Polymarket tend to outperform traditional pollsters because participants are financially incentivized to be correct. This creates more thoughtful, data-driven predictions. Research by James Surowiecki, author of The Wisdom of Crowds, has highlighted how markets like these can be more accurate than polls due to the “collective intelligence” of diverse participants. Additionally, the Iowa Electronic Markets, an academic research project at the University of Iowa, has consistently demonstrated the superior accuracy of prediction markets like Polymarket over traditional polling in predicting political outcomes.

Polymarket provides a constantly updating picture of public sentiment, offering a degree of accuracy and timeliness that traditional pollsters, who typically report data that is days old, simply cannot match.


Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/recover-missing-deposit.md b/docs/polymarket-learn/FAQ/recover-missing-deposit.md index c24ecda..a8c38c1 100644 --- a/docs/polymarket-learn/FAQ/recover-missing-deposit.md +++ b/docs/polymarket-learn/FAQ/recover-missing-deposit.md @@ -1,4 +1,4 @@ -Recover Missing Deposit | Polymarket Help Center
Skip to main content

Recover Missing Deposit

Sent the wrong token or used the wrong network when depositing? Here's how to recover your funds.

Updated this week

When does this apply?

This guide primarily covers situations where you transferred cryptocurrency directly to your Polymarket profile address instead of using the Deposit button.

What's a profile address? Your profile address is the Polygon wallet associated with your Polymarket account. It's different from your deposit address, which is the address shown when you click Deposit → Transfer Crypto. If you're unsure which address you sent to, contact support with your transaction hash and we'll help identify it.


Sent funds on Ethereum?

If you sent a token (such as ETH, USDC, USDT, or another ERC-20) on the Ethereum network to your profile address, you may be able to recover it using the Ethereum recovery tool:

  1. Connect the wallet you use on Polymarket, or sign in with your Polymarket account.

  2. If prompted, send the quoted amount of ETH to the owner address shown in the red box (this covers the gas fee for recovery).

  3. Search for the token you sent (ETH, USDC, USDT, etc.).

  4. Enter the external wallet address you'd like the funds returned to.

  5. Click Deploy Safe to return the funds to that address.


Sent funds on Polygon?

If you sent a non-USDC.e token (such as USDT, POL, or another asset) on the Polygon network to your profile address, you may be able to recover it using the Polygon recovery tool.

  1. Sign in using your Polymarket login method.

  2. If prompted, send the quoted amount of POL to the owner address shown in the red box.

  3. Search for the token you sent (USDT, POL, nUSD, etc.).

  4. If prompted, click Deploy Safe.

  5. Enter the external wallet address you'd like the funds returned to.


Sent funds on Base, Arbitrum, Optimism, or BSC?

Recovery tools also exist for other supported networks. If you sent funds to your profile address on Base, Arbitrum, Optimism, or BSC, please contact support with your transaction hash and we'll assist in deeming if the recovery is possible.

Please note: Not all recovery cases will be possible given these circumstances.


What can't be recovered

Due to the nature of blockchain transactions, some situations are unfortunately unrecoverable:

Funds sent to the CTF Exchange contract. If you sent tokens directly to a CTF exchange contract address (instead of your deposit or profile address), those funds are permanently locked in the contract. There is no mechanism for anyone, including the Polymarket team, to return or reverse the transfer.

  • Unsupported networks: If you sent funds on a network other than Ethereum, Polygon, Base, Arbitrum, Optimism, or BSC, recovery is not currently possible.

  • Funds sent to an address that isn't yours: If the receiving address doesn't belong to your Polymarket account, we cannot access or recover those funds.


Used the Deposit button but funds didn't arrive?

If you deposited using the Deposit → Transfer Crypto flow and your funds haven't appeared after 10 minutes:

  1. Double-check the transaction on a block explorer (Polygonscan, Etherscan, or Mempool for BTC) to confirm it was successful.

  2. Make sure you sent the correct token on the correct network, and that the amount meets the minimum deposit requirement for that network.

  3. Try refreshing the page or logging out and back in.

  4. If the transaction is confirmed on-chain but not reflected in your balance, contact support with your transaction hash and we'll investigate.


Need help?

If the recovery tool isn't working, or if your situation isn't covered above, contact support through the chat widget on polymarket.com (bottom-right corner). Please include:

  • Your transaction hash (Tx ID)

  • The token and approximate amount you sent

  • The network you sent on

This helps us diagnose and resolve your issue as quickly as possible.

Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Recover Missing Deposit

Sent the wrong token or used the wrong network when depositing? Here's how to recover your funds.

When does this apply?

This guide primarily covers situations where you transferred cryptocurrency directly to your Polymarket profile address instead of using the Deposit button.

What's a profile address? Your profile address is the Polygon wallet associated with your Polymarket account. It's different from your deposit address, which is the address shown when you click Deposit → Transfer Crypto. If you're unsure which address you sent to, contact support with your transaction hash and we'll help identify it.


Sent funds on Ethereum?

If you sent a token (such as ETH, USDC, USDT, or another ERC-20) on the Ethereum network to your profile address, you may be able to recover it using the Ethereum recovery tool:

  1. Connect the wallet you use on Polymarket, or sign in with your Polymarket account.

  2. If prompted, send the quoted amount of ETH to the owner address shown in the red box (this covers the gas fee for recovery).

  3. Search for the token you sent (ETH, USDC, USDT, etc.).

  4. Enter the external wallet address you'd like the funds returned to.

  5. Click Deploy Safe to return the funds to that address.


Sent funds on Polygon?

If you sent a non-pUSD token (such as USDT, POL, or another asset) on the Polygon network to your profile address, you may be able to recover it using the Polygon recovery tool.

  1. Sign in using your Polymarket login method.

  2. If prompted, send the quoted amount of POL to the owner address shown in the red box.

  3. Search for the token you sent (USDT, POL, nUSD, etc.).

  4. If prompted, click Deploy Safe.

  5. Enter the external wallet address you'd like the funds returned to.


Sent funds on Base, Arbitrum, Optimism, or BSC?

Recovery tools also exist for other supported networks. If you sent funds to your profile address on Base, Arbitrum, Optimism, or BSC, please contact support with your transaction hash and we'll assist in deeming if the recovery is possible.

Please note: Not all recovery cases will be possible given these circumstances.


What can't be recovered

Due to the nature of blockchain transactions, some situations are unfortunately unrecoverable:

Funds sent to the CTF Exchange contract. If you sent tokens directly to a CTF exchange contract address (instead of your deposit or profile address), those funds are permanently locked in the contract. There is no mechanism for anyone, including the Polymarket team, to return or reverse the transfer.

  • Unsupported networks: If you sent funds on a network other than Ethereum, Polygon, Base, Arbitrum, Optimism, or BSC, recovery is not currently possible.

  • Funds sent to an address that isn't yours: If the receiving address doesn't belong to your Polymarket account, we cannot access or recover those funds.


Used the Deposit button but funds didn't arrive?

If you deposited using the Deposit → Transfer Crypto flow and your funds haven't appeared after 10 minutes:

  1. Double-check the transaction on a block explorer (Polygonscan, Etherscan, or Mempool for BTC) to confirm it was successful.

  2. Make sure you sent the correct token on the correct network, and that the amount meets the minimum deposit requirement for that network.

  3. Try refreshing the page or logging out and back in.

  4. If the transaction is confirmed on-chain but not reflected in your balance, contact support with your transaction hash and we'll investigate.


Need help?

If the recovery tool isn't working, or if your situation isn't covered above, contact support through the chat widget on polymarket.com (bottom-right corner). Please include:

  • Your transaction hash (Tx ID)

  • The token and approximate amount you sent

  • The network you sent on

This helps us diagnose and resolve your issue as quickly as possible.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/sell-early.md b/docs/polymarket-learn/FAQ/sell-early.md index 5cf386d..264a813 100644 --- a/docs/polymarket-learn/FAQ/sell-early.md +++ b/docs/polymarket-learn/FAQ/sell-early.md @@ -1,4 +1,4 @@ -Can I Sell Early? | Polymarket Help Center
Skip to main content

Can I Sell Early?

Yes, you can sell or close your position early.

Updated over 3 months ago

You may sell shares at any point before the market is resolved by either placing a market order to sell shares at the prevailing bid price in the orderbook, or by placing a limit order for how many shares you wish to sell and at what price.

The limit order will only be executed if/when there is a willing buyer for your shares at the price you set.


Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Can I Sell Early?

Yes, you can sell or close your position early.

You may sell shares at any point before the market is resolved by either placing a market order to sell shares at the prevailing bid price in the orderbook, or by placing a limit order for how many shares you wish to sell and at what price.

The limit order will only be executed if/when there is a willing buyer for your shares at the price you set.


Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/support.md b/docs/polymarket-learn/FAQ/support.md index 8dec9ef..0973399 100644 --- a/docs/polymarket-learn/FAQ/support.md +++ b/docs/polymarket-learn/FAQ/support.md @@ -1,4 +1,4 @@ -How Do I Contact Support? | Polymarket Help Center
Skip to main content

How Do I Contact Support?

Updated over 3 months ago

Polymarket offers technical support through our website chat feature, and through Discord.

To contact support through our website:

  • Navigate to Polymarket.

  • Click the blue chat icon in the bottom right and start your chat session.

For technical support on Discord:

  • Navigate to the Support sidebar and click #open-a-ticket. This will open a private conversation with a Polymarket team member.

Be aware of numerous scams and malicious links. Polymarket team members will never DM you first or ask for private keys or personal information. Polymarket team members are identified in blue font on Discord.

Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

How Do I Contact Support?

Polymarket offers technical support through our website chat feature, and through Discord.

To contact support through our website:

  • Navigate to Polymarket.

  • Click the blue chat icon in the bottom right and start your chat session.

For technical support on Discord:

  • Navigate to the Support sidebar and click #open-a-ticket. This will open a private conversation with a Polymarket team member.

Be aware of numerous scams and malicious links. Polymarket team members will never DM you first or ask for private keys or personal information. Polymarket team members are identified in blue font on Discord.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/FAQ/wen-token.md b/docs/polymarket-learn/FAQ/wen-token.md index 9159ca2..92fc9e6 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?

Polymarket does not have a token

Updated over 3 months ago
Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Does Polymarket Have a Token?

Polymarket does not have a token

Did this answer your question?
\ 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 144d728..cc75150 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.

Updated over 3 months ago

A prediction market is a platform where people can bet on the outcome of future events. By buying and selling shares in the outcomes, participants collectively forecast the likelihood of events such as sports results, political elections, or entertainment awards.

​How it works

Market Prices = Probabilities: The price of shares in a prediction market represents the current probability of an event happening. For example, if shares of an event are trading at 20 cents, it indicates a 20% chance of that event occurring.

​Making predictions

If you believe the actual probability of an event is higher than the market price suggests, you can buy shares. For instance, if you think a team has a better than 20% chance of winning, you would buy shares at 20 cents. If the event occurs, each share becomes worth $1, yielding a profit.

​Free-market trading

You can buy or sell shares at any time before the event concludes, based on new information or changing circumstances. This flexibility allows the market prices to continuously reflect the most current and accurate probabilities.

​Trust the markets

Prediction markets provide unbiased and accurate probabilities in real time, cutting through the noise of human and media biases. Traditional sources often have their own incentives and slants, but prediction markets operate on the principle of “put your money where your mouth is.” Here, participants are financially motivated to provide truthful insights, as their profits depend on the accuracy of their predictions.

In a prediction market, prices reflect the aggregated sentiment of all participants, weighing news, data, expert opinions, and culture to determine the true odds. Unlike media narratives, which can be swayed by various biases, prediction markets offer a transparent view of where people genuinely believe we’re heading.

​Why use prediction markets?

Prediction markets are often more accurate than traditional polls and expert predictions. The collective wisdom of diverse participants, each motivated by the potential for profit, leads to highly reliable forecasts. This makes prediction markets an excellent tool for gauging real-time probabilities of future events.

Polymarket, the world’s largest prediction market, offers a user-friendly platform to bet on a wide range of topics, from sports to politics. By participating, you can profit from your knowledge while contributing to the accuracy of market predictions.

Did this answer your question?
+--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 bet on the outcome of future events. By buying and selling shares in the outcomes, participants collectively forecast the likelihood of events such as sports results, political elections, or entertainment awards.

​How it works

Market Prices = Probabilities: The price of shares in a prediction market represents the current probability of an event happening. For example, if shares of an event are trading at 20 cents, it indicates a 20% chance of that event occurring.

​Making predictions

If you believe the actual probability of an event is higher than the market price suggests, you can buy shares. For instance, if you think a team has a better than 20% chance of winning, you would buy shares at 20 cents. If the event occurs, each share becomes worth $1, yielding a profit.

​Free-market trading

You can buy or sell shares at any time before the event concludes, based on new information or changing circumstances. This flexibility allows the market prices to continuously reflect the most current and accurate probabilities.

​Trust the markets

Prediction markets provide unbiased and accurate probabilities in real time, cutting through the noise of human and media biases. Traditional sources often have their own incentives and slants, but prediction markets operate on the principle of “put your money where your mouth is.” Here, participants are financially motivated to provide truthful insights, as their profits depend on the accuracy of their predictions.

In a prediction market, prices reflect the aggregated sentiment of all participants, weighing news, data, expert opinions, and culture to determine the true odds. Unlike media narratives, which can be swayed by various biases, prediction markets offer a transparent view of where people genuinely believe we’re heading.

​Why use prediction markets?

Prediction markets are often more accurate than traditional polls and expert predictions. The collective wisdom of diverse participants, each motivated by the potential for profit, leads to highly reliable forecasts. This makes prediction markets an excellent tool for gauging real-time probabilities of future events.

Polymarket, the world’s largest prediction market, offers a user-friendly platform to bet on a wide range of topics, from sports to politics. By participating, you can profit from your knowledge while contributing to the accuracy of market predictions.

Did this answer your question?
\ 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 ecb970a..47a45dd 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.

Updated over 3 months ago

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.

Did this answer your question?
+--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.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/deposits/coinbase.md b/docs/polymarket-learn/deposits/coinbase.md index 4c6775a..18074f2 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.

Updated over 2 weeks ago

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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
+--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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
\ 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 622877a..4b918e8 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

Updated over 3 months ago
Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

How to Withdraw

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/deposits/moonpay.md b/docs/polymarket-learn/deposits/moonpay.md index c0be1e7..3ea492d 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.

Updated over 2 weeks ago

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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
+--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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
\ 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 97a917e..a067415 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.

Updated over 2 weeks ago

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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
+--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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
\ 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 c1dd02f..6efdf39 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.

Updated over 2 weeks ago

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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
+--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.

  4. Copy your deposit address.

  5. Send the minimum required amount to that address.

  6. After the transaction confirms, refresh the page — your funds will appear in your balance.

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

Did this answer your question?
\ 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 37ebe2c..116ba0b 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.

Updated over 3 months ago

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.

Did this answer your question?
+--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.

Did this answer your question?
\ 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 330ac59..82de44a 100644 --- a/docs/polymarket-learn/get-started/making-your-first-trade.md +++ b/docs/polymarket-learn/get-started/making-your-first-trade.md @@ -60,8 +60,8 @@ The simplest way to place a limit order — create, sign, and submit in one call ``` ```python Python theme={null} - from py_clob_client.clob_types import OrderArgs, OrderType - from py_clob_client.order_builder.constants import BUY + from py_clob_client_v2 import OrderArgs, OrderType, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY response = client.create_and_post_order( OrderArgs( @@ -70,10 +70,7 @@ The simplest way to place a limit order — create, sign, and submit in one call size=10, side=BUY, ), - options={ - "tick_size": "0.01", - "neg_risk": False, - }, + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), order_type=OrderType.GTC ) @@ -82,8 +79,8 @@ The simplest way to place a limit order — create, sign, and submit in one call ``` ```rust Rust theme={null} - use polymarket_client_sdk::clob::types::Side; - use polymarket_client_sdk::types::dec; + use polymarket_client_sdk_v2::clob::types::Side; + use polymarket_client_sdk_v2::types::dec; let token_id = "TOKEN_ID".parse()?; let order = client @@ -132,10 +129,7 @@ For more control, you can separate signing from submission. This is useful for b size=10, side=BUY, ), - options={ - "tick_size": "0.01", - "neg_risk": False, - } + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False) ) # Step 2: Submit to the CLOB @@ -197,17 +191,14 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even side=BUY, expiration=expiration, ), - options={ - "tick_size": "0.01", - "neg_risk": False, - }, + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), order_type=OrderType.GTD ) ``` ```rust Rust theme={null} use chrono::{TimeDelta, Utc}; - use polymarket_client_sdk::clob::types::OrderType; + use polymarket_client_sdk_v2::clob::types::OrderType; let order = client .limit_order() @@ -266,32 +257,36 @@ Market orders execute immediately against resting liquidity using FOK or FAK typ ``` ```python Python theme={null} - from py_clob_client.order_builder.constants import BUY, SELL - from py_clob_client.clob_types import OrderType + from py_clob_client_v2.order_builder.constants import BUY, SELL + from py_clob_client_v2 import MarketOrderArgs, OrderType, PartialCreateOrderOptions # FOK BUY: spend exactly $100 or cancel entirely buy_order = client.create_market_order( - token_id="TOKEN_ID", - side=BUY, - amount=100, # dollar amount - price=0.50, # worst-price limit (slippage protection) - options={"tick_size": "0.01", "neg_risk": False}, + order_args=MarketOrderArgs( + token_id="TOKEN_ID", + side=BUY, + amount=100, # dollar amount + price=0.50, # worst-price limit (slippage protection) + ), + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), ) client.post_order(buy_order, OrderType.FOK) # FOK SELL: sell exactly 200 shares or cancel entirely sell_order = client.create_market_order( - token_id="TOKEN_ID", - side=SELL, - amount=200, # number of shares - price=0.45, # worst-price limit (slippage protection) - options={"tick_size": "0.01", "neg_risk": False}, + order_args=MarketOrderArgs( + token_id="TOKEN_ID", + side=SELL, + amount=200, # number of shares + price=0.45, # worst-price limit (slippage protection) + ), + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), ) client.post_order(sell_order, OrderType.FOK) ``` ```rust Rust theme={null} - use polymarket_client_sdk::clob::types::{Amount, OrderType, Side}; + use polymarket_client_sdk_v2::clob::types::{Amount, OrderType, Side}; let token_id = "TOKEN_ID".parse()?; @@ -347,12 +342,17 @@ For convenience, `createAndPostMarketOrder` handles creation, signing, and submi ``` ```python Python theme={null} + from py_clob_client_v2 import MarketOrderArgs, OrderType, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY + response = client.create_and_post_market_order( - token_id="TOKEN_ID", - side=BUY, - amount=100, - price=0.50, - options={"tick_size": "0.01", "neg_risk": False}, + order_args=MarketOrderArgs( + token_id="TOKEN_ID", + side=BUY, + amount=100, + price=0.50, + ), + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), order_type=OrderType.FOK, ) ``` @@ -446,26 +446,26 @@ Place up to **15 orders** in a single request: ``` ```python Python theme={null} - from py_clob_client.clob_types import OrderArgs, OrderType, PostOrdersArgs - from py_clob_client.order_builder.constants import BUY, SELL + from py_clob_client_v2 import OrderArgs, OrderType, PostOrdersV2Args, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY, SELL response = client.post_orders([ - PostOrdersArgs( + PostOrdersV2Args( order=client.create_order(OrderArgs( price=0.48, size=500, side=BUY, token_id="TOKEN_ID", - ), options={"tick_size": "0.01", "neg_risk": False}), + ), options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False)), orderType=OrderType.GTC, ), - PostOrdersArgs( + PostOrdersV2Args( order=client.create_order(OrderArgs( price=0.52, size=500, side=SELL, token_id="TOKEN_ID", - ), options={"tick_size": "0.01", "neg_risk": False}), + ), options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False)), orderType=OrderType.GTC, ), ]) diff --git a/docs/polymarket-learn/get-started/what-is-polymarket.md b/docs/polymarket-learn/get-started/what-is-polymarket.md index c18e55e..7c18351 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.

Updated over 3 months ago

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 representing future event outcomes (i.e. “Will TikTok be banned in the U.S. this year?”)buy and sell shares

  • 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.always pricedUSDC

  • Shares are created when , such that 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.

Did this answer your question?
+--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 representing future event outcomes (i.e. “Will TikTok be banned in the U.S. this year?”)buy and sell shares

  • 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.always pricedUSDC

  • Shares are created when , such that 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.

Did this answer your question?
\ No newline at end of file diff --git a/docs/polymarket-learn/markets/dispute.md b/docs/polymarket-learn/markets/dispute.md index 77dd7dc..4a23681 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.

Updated over 3 weeks ago

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.

Did this answer your question?
+--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.

Did this answer your question?
\ 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 92ec0cb..7162ce2 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?

Updated over 3 months ago
Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

How Are Markets Clarified?

How are markets on Polymarket clarified?

Did this answer your question?
\ 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 8d1f2bf..08cadb3 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.

Updated over a week ago


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

Did this answer your question?
+--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

Did this answer your question?
\ 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 ff90089..4f58a31 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.

Updated over 3 months ago

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.

Did this answer your question?
+--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.

Did this answer your question?
\ 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 5925861..04e8b60 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

How to buy shares.

Updated over 3 months ago

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:

Did this answer your question?
+--text-on-primary-color: #ffffff}
Skip to main content

Holding Rewards

How to buy shares.

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:

Did this answer your question?
\ 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 49dee1e..2e720e8 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.

Updated over a month ago


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.

Did this answer your question?
+--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.

Did this answer your question?
\ 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 eb4ddd0..15fd50e 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.

Updated this week

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

Did this answer your question?
+--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

Did this answer your question?
\ 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 61c97f9..5212233 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

Updated over 3 months ago

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.

  • 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.

Did this answer your question?
+--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.

  • 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.

Did this answer your question?
\ 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 330ac59..82de44a 100644 --- a/docs/polymarket-learn/trading/market-orders.md +++ b/docs/polymarket-learn/trading/market-orders.md @@ -60,8 +60,8 @@ The simplest way to place a limit order — create, sign, and submit in one call ``` ```python Python theme={null} - from py_clob_client.clob_types import OrderArgs, OrderType - from py_clob_client.order_builder.constants import BUY + from py_clob_client_v2 import OrderArgs, OrderType, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY response = client.create_and_post_order( OrderArgs( @@ -70,10 +70,7 @@ The simplest way to place a limit order — create, sign, and submit in one call size=10, side=BUY, ), - options={ - "tick_size": "0.01", - "neg_risk": False, - }, + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), order_type=OrderType.GTC ) @@ -82,8 +79,8 @@ The simplest way to place a limit order — create, sign, and submit in one call ``` ```rust Rust theme={null} - use polymarket_client_sdk::clob::types::Side; - use polymarket_client_sdk::types::dec; + use polymarket_client_sdk_v2::clob::types::Side; + use polymarket_client_sdk_v2::types::dec; let token_id = "TOKEN_ID".parse()?; let order = client @@ -132,10 +129,7 @@ For more control, you can separate signing from submission. This is useful for b size=10, side=BUY, ), - options={ - "tick_size": "0.01", - "neg_risk": False, - } + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False) ) # Step 2: Submit to the CLOB @@ -197,17 +191,14 @@ GTD orders auto-expire at a specified time. Useful for quoting around known even side=BUY, expiration=expiration, ), - options={ - "tick_size": "0.01", - "neg_risk": False, - }, + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), order_type=OrderType.GTD ) ``` ```rust Rust theme={null} use chrono::{TimeDelta, Utc}; - use polymarket_client_sdk::clob::types::OrderType; + use polymarket_client_sdk_v2::clob::types::OrderType; let order = client .limit_order() @@ -266,32 +257,36 @@ Market orders execute immediately against resting liquidity using FOK or FAK typ ``` ```python Python theme={null} - from py_clob_client.order_builder.constants import BUY, SELL - from py_clob_client.clob_types import OrderType + from py_clob_client_v2.order_builder.constants import BUY, SELL + from py_clob_client_v2 import MarketOrderArgs, OrderType, PartialCreateOrderOptions # FOK BUY: spend exactly $100 or cancel entirely buy_order = client.create_market_order( - token_id="TOKEN_ID", - side=BUY, - amount=100, # dollar amount - price=0.50, # worst-price limit (slippage protection) - options={"tick_size": "0.01", "neg_risk": False}, + order_args=MarketOrderArgs( + token_id="TOKEN_ID", + side=BUY, + amount=100, # dollar amount + price=0.50, # worst-price limit (slippage protection) + ), + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), ) client.post_order(buy_order, OrderType.FOK) # FOK SELL: sell exactly 200 shares or cancel entirely sell_order = client.create_market_order( - token_id="TOKEN_ID", - side=SELL, - amount=200, # number of shares - price=0.45, # worst-price limit (slippage protection) - options={"tick_size": "0.01", "neg_risk": False}, + order_args=MarketOrderArgs( + token_id="TOKEN_ID", + side=SELL, + amount=200, # number of shares + price=0.45, # worst-price limit (slippage protection) + ), + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), ) client.post_order(sell_order, OrderType.FOK) ``` ```rust Rust theme={null} - use polymarket_client_sdk::clob::types::{Amount, OrderType, Side}; + use polymarket_client_sdk_v2::clob::types::{Amount, OrderType, Side}; let token_id = "TOKEN_ID".parse()?; @@ -347,12 +342,17 @@ For convenience, `createAndPostMarketOrder` handles creation, signing, and submi ``` ```python Python theme={null} + from py_clob_client_v2 import MarketOrderArgs, OrderType, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY + response = client.create_and_post_market_order( - token_id="TOKEN_ID", - side=BUY, - amount=100, - price=0.50, - options={"tick_size": "0.01", "neg_risk": False}, + order_args=MarketOrderArgs( + token_id="TOKEN_ID", + side=BUY, + amount=100, + price=0.50, + ), + options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False), order_type=OrderType.FOK, ) ``` @@ -446,26 +446,26 @@ Place up to **15 orders** in a single request: ``` ```python Python theme={null} - from py_clob_client.clob_types import OrderArgs, OrderType, PostOrdersArgs - from py_clob_client.order_builder.constants import BUY, SELL + from py_clob_client_v2 import OrderArgs, OrderType, PostOrdersV2Args, PartialCreateOrderOptions + from py_clob_client_v2.order_builder.constants import BUY, SELL response = client.post_orders([ - PostOrdersArgs( + PostOrdersV2Args( order=client.create_order(OrderArgs( price=0.48, size=500, side=BUY, token_id="TOKEN_ID", - ), options={"tick_size": "0.01", "neg_risk": False}), + ), options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False)), orderType=OrderType.GTC, ), - PostOrdersArgs( + PostOrdersV2Args( order=client.create_order(OrderArgs( price=0.52, size=500, side=SELL, token_id="TOKEN_ID", - ), options={"tick_size": "0.01", "neg_risk": False}), + ), options=PartialCreateOrderOptions(tick_size="0.01", neg_risk=False)), orderType=OrderType.GTC, ), ]) diff --git a/docs/polymarket-learn/trading/no-limits.md b/docs/polymarket-learn/trading/no-limits.md index 1831ed0..3c8ae56 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.

Updated over 3 months ago

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.


Did this answer your question?
+--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.


Did this answer your question?
\ No newline at end of file