gavindiaz/PolymarketDocumentation
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update Polymarket documentation (2026-02-19)

Browse Source 
- Added new documentation URLs from llms.txt index
- Updated TARGET.md with 244 total documentation pages
- Scraped new pages for trading, concepts, and API reference sections
- Updated changelog and new index pages
This commit is contained in:
AI Agent
2026-02-19 14:31:02 +01:00
parent 81f77eff3c
commit b2a29fe51f
250 changed files with 33306 additions and 9659 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/trading/bridge/deposit.md
+105
View File
@@ -0,0 +1,105 @@
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Deposit
> Bridge assets from any supported chain to fund your Polymarket account
Polymarket uses **USDC.e** (Bridged USDC) on Polygon as collateral for all trading. The Bridge API lets you deposit assets from Ethereum, Solana, Bitcoin, and other chains—they're automatically converted to USDC.e on Polygon.
## How It Works
1. Request deposit addresses for your Polymarket wallet
2. Send assets to the appropriate address for your source chain
3. Assets are bridged and swapped to USDC.e automatically
4. USDC.e is credited to your wallet for trading
## Create Deposit Addresses
Generate unique deposit addresses linked to your Polymarket wallet. See the [Bridge API Reference](/api-reference/introduction) for full request and response schemas.
```bash theme={null}
curl -X POST https://bridge.polymarket.com/deposit \
-H "Content-Type: application/json" \
-d '{"address": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"}'
```
### Address Types
| Address | Use For |
| ------- | -------------------------------------------------------- |
| `evm` | Ethereum, Arbitrum, Base, Optimism, and other EVM chains |
| `svm` | Solana |
| `btc` | Bitcoin |
| `tvm` | Tron |
<Warning>
Each address is unique to your wallet. Only send assets from supported chains
to the correct address type.
</Warning>
## Deposit Flow
<Steps>
<Step title="Get Your Deposit Address">
Call `POST /deposit` with your Polymarket wallet address to get deposit
addresses.
</Step>
<Step title="Check Supported Assets">
Verify your token is supported and meets the minimum deposit amount via
`/supported-assets`.
</Step>
<Step title="Send Assets">
Transfer tokens to the appropriate deposit address from your source chain.
</Step>
<Step title="Track Status">
Monitor your deposit progress using `/status/{address}`.
</Step>
</Steps>
## USDC vs USDC.e
You can deposit either USDC (native) or USDC.e (bridged) to your Polymarket wallet. If you deposit native USDC, you will be prompted to "activate funds," which swaps it to USDC.e via the lowest-fee Uniswap pool (less than 10bp slippage).
## Large Deposits
For deposits over \$50,000 originating from a chain other than Polygon, we recommend using a third-party bridge to minimize slippage:
* [DeBridge](https://app.debridge.finance/)
* [Across](https://app.across.to/bridge)
* [Portal](https://portalbridge.com/)
Bridge directly to your Polymarket USDC (Polygon) deposit address. Polymarket is not affiliated with or responsible for any third-party bridge.
## Minimum Deposits
Each asset has a minimum deposit amount. Deposits below the minimum will not be processed. Check `/supported-assets` for current minimums.
## Deposit Recovery
If you deposited the wrong token on Ethereum or Polygon, use these tools to recover your funds:
* **Ethereum deposits**: [recovery.polymarket.com](https://recovery.polymarket.com/)
* **Polygon deposits**: [matic-recovery.polymarket.com](https://matic-recovery.polymarket.com/)
<Warning>
Sending unsupported tokens may cause **irrecoverable loss**. Always verify
your token is listed in [Supported Assets](/trading/bridge/supported-assets)
before depositing.
</Warning>
## Next Steps
<CardGroup cols={2}>
<Card title="Supported Assets" icon="coins" href="/trading/bridge/supported-assets">
See all supported chains and tokens with minimum amounts.
</Card>
<Card title="Check Status" icon="clock" href="/trading/bridge/status">
Track your deposit progress through completion.
</Card>
</CardGroup>
docs/trading/bridge/overview.md
+1
View File
@@ -0,0 +1 @@
null
docs/trading/bridge/quote.md
+117
View File
@@ -0,0 +1,117 @@
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Quote
> Preview fees and estimated output for deposits and withdrawals
Get an estimated quote before executing a deposit or withdrawal. Quotes include estimated output amounts, checkout time, and a detailed fee breakdown.
## Get a Quote
```bash theme={null}
curl -X POST https://bridge.polymarket.com/quote \
-H "Content-Type: application/json" \
-d '{
"fromAmountBaseUnit": "10000000",
"fromChainId": "137",
"fromTokenAddress": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"recipientAddress": "0x17eC161f126e82A8ba337f4022d574DBEaFef575",
"toChainId": "137",
"toTokenAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"
}'
```
### Request Parameters
| Parameter | Type | Description |
| -------------------- | ------ | ------------------------------------------------------------- |
| `fromAmountBaseUnit` | string | Amount to send in base units (e.g., `"10000000"` for 10 USDC) |
| `fromChainId` | string | Source chain ID (e.g., `"137"` for Polygon) |
| `fromTokenAddress` | string | Token contract address on the source chain |
| `recipientAddress` | string | Destination wallet address to receive funds |
| `toChainId` | string | Destination chain ID |
| `toTokenAddress` | string | Token contract address on the destination chain |
### Response
The quote response includes:
| Field | Type | Description |
| -------------------- | ------ | --------------------------------------- |
| `estCheckoutTimeMs` | number | Estimated checkout time in milliseconds |
| `estInputUsd` | number | Estimated input value in USD |
| `estOutputUsd` | number | Estimated output value in USD |
| `estToTokenBaseUnit` | string | Estimated output amount in base units |
| `quoteId` | string | Unique identifier for this quote |
| `estFeeBreakdown` | object | Detailed fee breakdown (see below) |
### Fee Breakdown
The `estFeeBreakdown` object contains:
<ResponseField name="gasUsd" type="number">
Gas fee in USD
</ResponseField>
<ResponseField name="appFeeLabel" type="string">
Label of the app fee
</ResponseField>
<ResponseField name="appFeePercent" type="number">
App fee as a percentage of the total amount
</ResponseField>
<ResponseField name="appFeeUsd" type="number">
App fee in USD
</ResponseField>
<ResponseField name="fillCostPercent" type="number">
Fill cost as a percentage of the total amount
</ResponseField>
<ResponseField name="fillCostUsd" type="number">
Fill cost in USD
</ResponseField>
<ResponseField name="maxSlippage" type="number">
Maximum potential slippage as a percentage
</ResponseField>
<ResponseField name="minReceived" type="number">
Minimum amount received after slippage
</ResponseField>
<ResponseField name="swapImpact" type="number">
Swap impact as a percentage of the total amount
</ResponseField>
<ResponseField name="swapImpactUsd" type="number">
Swap impact in USD
</ResponseField>
<ResponseField name="totalImpact" type="number">
Total impact as a percentage of the total amount
</ResponseField>
<ResponseField name="totalImpactUsd" type="number">
Total impact cost in USD
</ResponseField>
<Note>
Quotes are estimates. Actual amounts may vary slightly due to market
conditions.
</Note>
## Next Steps
<CardGroup cols={2}>
<Card title="Create Deposit" icon="arrow-right-to-bracket" href="/trading/bridge/deposit">
Execute a deposit to Polymarket.
</Card>
<Card title="Withdraw" icon="arrow-right-from-bracket" href="/trading/bridge/withdraw">
Withdraw from Polymarket to another chain.
</Card>
</CardGroup>
docs/trading/bridge/status.md
+95
View File
@@ -0,0 +1,95 @@
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Deposit Status
> Track the progress of your bridge deposits
After sending assets to your deposit address, use the status endpoint to track progress until funds arrive in your Polymarket wallet.
## Check Status
Query the status of all deposits to a specific deposit address.
```bash theme={null}
curl https://bridge.polymarket.com/status/0x23566f8b2E82aDfCf01846E54899d110e97AC053
```
<Note>
Use the deposit address from the `/deposit` response (EVM, SVM, or BTC), not
your Polymarket wallet address.
</Note>
## Transaction Statuses
Each deposit progresses through these statuses:
| Status | Terminal | Description |
| --------------------- | -------- | -------------------------------------------------- |
| `DEPOSIT_DETECTED` | No | Funds detected on source chain, not yet processing |
| `PROCESSING` | No | Transaction is being routed and swapped |
| `ORIGIN_TX_CONFIRMED` | No | Source chain transaction confirmed |
| `SUBMITTED` | No | Submitted to destination chain (Polygon) |
| `COMPLETED` | Yes | Funds arrived — transaction successful |
| `FAILED` | Yes | Transaction encountered an error |
## Response
A response with active deposits:
```json theme={null}
{
"transactions": [
{
"fromChainId": "1",
"fromTokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"fromAmountBaseUnit": "1000000000",
"toChainId": "137",
"toTokenAddress": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
"status": "COMPLETED",
"txHash": "0xabc123...",
"createdTimeMs": 1697875200000
}
]
}
```
| Field | Description |
| -------------------- | ----------------------------------------------------------------------------------------- |
| `fromChainId` | Source chain ID |
| `fromTokenAddress` | Token sent |
| `fromAmountBaseUnit` | Amount in base units |
| `toChainId` | Destination chain (137 for Polygon) |
| `toTokenAddress` | Token received |
| `status` | Current status (see table above) |
| `txHash` | Destination transaction hash (only when `COMPLETED`) |
| `createdTimeMs` | Unix timestamp in milliseconds (only present once the transaction has started processing) |
## Empty Response
An empty `transactions` array means no deposits have been detected at this address yet:
```json theme={null}
{
"transactions": []
}
```
<Tip>
Transactions typically complete within a few minutes, but may take longer
depending on network conditions. Poll every 10-30 seconds until `COMPLETED` or
`FAILED`.
</Tip>
## Next Steps
<CardGroup cols={2}>
<Card title="Create Deposit" icon="arrow-right-to-bracket" href="/trading/bridge/deposit">
Generate deposit addresses for your wallet.
</Card>
<Card title="Supported Assets" icon="coins" href="/trading/bridge/supported-assets">
Check supported chains and minimum amounts.
</Card>
</CardGroup>
docs/trading/bridge/supported-assets.md
+62
View File
@@ -0,0 +1,62 @@
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Supported Assets
> Chains and tokens supported for deposits to Polymarket
The Bridge API supports deposits from multiple chains and tokens. All deposits are automatically converted to **USDC.e on Polygon**, which is used as collateral for trading on Polymarket.
## Get Supported Assets
Retrieve the full list of supported chains and tokens with their minimum deposit amounts.
```bash theme={null}
curl https://bridge.polymarket.com/supported-assets
```
## Supported Chains
The bridge supports deposits from these blockchain networks:
| Chain | Address Type | Min Deposit | Example Tokens |
| --------------- | ------------ | ----------- | ------------------------------------------- |
| Ethereum | EVM | \$7 | ETH, USDC, USDT, WBTC, DAI, LINK, UNI, AAVE |
| Polygon | EVM | \$2 | POL, USDC, USDT, DAI, WETH, SAND |
| Arbitrum | EVM | \$2 | ETH, ARB, USDC, USDT, DAI, WBTC, USDe |
| Base | EVM | \$2 | ETH, USDC, USDT, DAI, cbBTC, AERO, USDS |
| Optimism | EVM | \$2 | ETH, OP, USDC, USDT, DAI, USDe |
| BNB Smart Chain | EVM | \$2 | BNB, USDC, USDT, DAI, ETH, BTCB, BUSD |
| Solana | SVM | \$2 | SOL, USDC, USDT, USDe, TRUMP |
| Bitcoin | BTC | \$9 | BTC |
| Tron | TVM | \$9 | USDT |
| HyperEVM | EVM | \$2 | HYPE, USDC, USDe, stHYPE, UBTC, UETH |
| Abstract | EVM | \$2 | ETH, USDC, USDT |
| Monad | EVM | \$2 | MON, USDC, USDT |
| Ethereal | EVM | \$2 | USDe, WUSDe |
| Katana | EVM | \$2 | AUSD |
| Lighter | EVM | \$2 | USDC |
<Note>
Supported assets change over time. Always call `/supported-assets` for the
current list before initiating a deposit.
</Note>
## Minimum Amounts
Each asset has a `minCheckoutUsd` value—the minimum deposit amount in USD equivalent. Deposits below this threshold may fail to process.
Most L2 chains (Polygon, Arbitrum, Base, Optimism) have low minimums of $2, while Ethereum deposits require $7 minimum. Bitcoin and Tron have \$9 minimums due to higher bridging costs.
## Next Steps
<CardGroup cols={2}>
<Card title="Create Deposit" icon="arrow-right-to-bracket" href="/trading/bridge/deposit">
Generate deposit addresses for your wallet.
</Card>
<Card title="Check Status" icon="clock" href="/trading/bridge/status">
Track your deposit progress.
</Card>
</CardGroup>
docs/trading/bridge/withdraw.md
+102
View File
@@ -0,0 +1,102 @@
> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Withdraw
> Bridge USDC.e from Polymarket to any supported chain
Withdraw USDC.e from your Polymarket wallet to any supported chain and token. Funds are automatically bridged and swapped to your desired token on the destination chain.
## How It Works
1. Specify your destination chain, token, and recipient address
2. Receive deposit addresses for each destination chain (EVM, Solana, Bitcoin)
3. Send USDC.e from your Polymarket wallet to the appropriate deposit address
4. Funds are automatically bridged and swapped to your desired token
5. Funds arrive at your destination wallet
<Warning>
Do not pre-generate withdrawal addresses. Only generate them when you are
ready to execute the withdrawal. Each address is configured for a specific
destination.
</Warning>
<Warning>
When withdrawing, USDC.e (bridged USDC) is swapped through the
[Uniswap v3 pool](https://polygonscan.com/address/0xd36ec33c8bed5a9f7b6630855f1533455b98a418)
for USDC (native). The UI enforces less than 10bp difference in output amount.
At times, this pool may be exhausted. If you are having withdraw issues, try
breaking your withdraw into smaller amounts or waiting for the pool to be
rebalanced. Alternatively, you can withdraw USDC.e directly, which does not
require Uniswap liquidity — just be aware that some exchanges no longer accept
USDC.e deposits directly.
</Warning>
<Tip>
For very large withdrawals (over \$50,000), consider breaking the withdrawal
into smaller amounts or using a third-party bridge to minimize slippage.
</Tip>
## Create Withdrawal Addresses
Generate deposit addresses configured for your withdrawal destination. See the [Bridge API Reference](/api-reference/introduction) for full request and response schemas.
```bash theme={null}
curl -X POST https://bridge.polymarket.com/withdraw \
-H "Content-Type: application/json" \
-d '{
"address": "0x9156dd10bea4c8d7e2d591b633d1694b1d764756",
"toChainId": "1",
"toTokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"recipientAddr": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}'
```
### Address Types
| Address | Use For |
| ------- | -------------------------------------------------------- |
| `evm` | Ethereum, Arbitrum, Base, Optimism, and other EVM chains |
| `svm` | Solana |
| `btc` | Bitcoin |
| `tvm` | Tron |
Withdrawals are **instant** and **free** — Polymarket does not charge withdrawal fees.
## Withdrawal Flow
<Steps>
<Step title="Check Supported Assets">
Verify your destination chain and token are supported via
`/supported-assets`.
</Step>
<Step title="Get a Quote">
Preview fees and estimated output via `POST /quote`.
</Step>
<Step title="Create Withdrawal Addresses">
Call `POST /withdraw` with your wallet address, destination chain, token,
and recipient.
</Step>
<Step title="Send USDC.e">
Transfer USDC.e from your Polymarket wallet to the appropriate deposit
address.
</Step>
<Step title="Track Status">Monitor progress using `/status/{address}`.</Step>
</Steps>
## Next Steps
<CardGroup cols={2}>
<Card title="Get a Quote" icon="calculator" href="/trading/bridge/quote">
Preview fees and estimated output before withdrawing.
</Card>
<Card title="Check Status" icon="clock" href="/trading/bridge/status">
Track your withdrawal progress.
</Card>
</CardGroup>