Update Polymarket documentation - whitespace normalization (2026-04-07)

This commit is contained in:
Etherdrake
2026-04-07 14:06:13 +02:00
parent 8c597b8fbe
commit ad5a26710b
189 changed files with 667 additions and 455 deletions
+1 -1
View File
@@ -424,4 +424,4 @@ When initializing the L2 client, you must specify your wallet **signatureType**
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -370,4 +370,4 @@ async revokeBuilderApiKey(): Promise<any>
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -405,4 +405,4 @@ async createMarketOrder(
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -772,4 +772,4 @@ async dropNotifications(params?: DropNotificationParams): Promise<void>
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -108,4 +108,4 @@ For [gasless transactions](/trading/gasless) using proxy wallets, the relayer cl
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -663,4 +663,4 @@ async getServerTime(): Promise<number>
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -209,4 +209,4 @@ If you believe you are incorrectly restricted or have questions about geographic
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -231,4 +231,4 @@ If you're using the REST API directly (without the SDK), you need to attach auth
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -401,4 +401,4 @@ Check if your resting orders are eligible for [maker rebates](/market-makers/mak
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -542,4 +542,4 @@ The operator's privileges are limited to order matching and ensuring correct ord
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -694,4 +694,4 @@ The heartbeat endpoint maintains session liveness. If a valid heartbeat is not r
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -694,4 +694,4 @@ The heartbeat endpoint maintains session liveness. If a valid heartbeat is not r
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -542,4 +542,4 @@ The operator's privileges are limited to order matching and ensuring correct ord
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -542,4 +542,4 @@ The operator's privileges are limited to order matching and ensuring correct ord
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -542,4 +542,4 @@ The operator's privileges are limited to order matching and ensuring correct ord
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -542,4 +542,4 @@ The operator's privileges are limited to order matching and ensuring correct ord
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -285,4 +285,4 @@ This guide walks you through placing an order on Polymarket end-to-end.
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -136,4 +136,4 @@ components:
````
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -231,4 +231,4 @@ If you're using the REST API directly (without the SDK), you need to attach auth
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -231,4 +231,4 @@ If you're using the REST API directly (without the SDK), you need to attach auth
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -146,7 +146,17 @@ Emitted when a new market is created.
The payload also includes market metadata fields such as `tags`,
`condition_id`, `active`, `clob_token_ids`, `sports_market_type`, `line`,
`game_start_time`, `order_price_min_tick_size`, and `group_item_title`.
`game_start_time`, `order_price_min_tick_size`, `group_item_title`,
`taker_base_fee`, `fees_enabled`, and `fee_schedule`.
Where a `FeeSchedule` object is of the form:
| Name | Type | Description |
| ------------ | ------- | --------------------------------- |
| exponent | string | fee curve exponent |
| rate | string | fee rate |
| taker\_only | boolean | whether fee applies to taker only |
| rebate\_rate | string | maker rebate rate |
```json theme={null}
{
@@ -180,7 +190,15 @@ The payload also includes market metadata fields such as `tags`,
"line": "",
"game_start_time": "",
"order_price_min_tick_size": "0.01",
"group_item_title": "NVDA above $240"
"group_item_title": "NVDA above $240",
"taker_base_fee": "0",
"fees_enabled": true,
"fee_schedule": {
"exponent": "2",
"rate": "0.02",
"taker_only": true,
"rebate_rate": "0"
}
}
```
@@ -217,4 +235,4 @@ Emitted when a market is resolved.
```
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -124,4 +124,4 @@ Emitted when:
```
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -181,4 +181,4 @@ pong
</Accordion>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -181,4 +181,4 @@ pong
</Accordion>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -106,4 +106,4 @@ All Polymarket contracts are deployed on **Polygon mainnet** (Chain ID: 137). Th
</CodeGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -63,4 +63,4 @@ The operation is atomic — if you don't have enough of both tokens, the transac
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -140,4 +140,4 @@ See [Contract Addresses](/resources/contract-addresses) for all Polymarket smart
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -94,4 +94,4 @@ When you call `redeemPositions()`:
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -69,4 +69,4 @@ The operation is atomic — if any step fails, the entire transaction reverts.
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -546,4 +546,4 @@ Comments support nested threading:
</Accordion>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -546,4 +546,4 @@ Comments support nested threading:
</Accordion>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -546,4 +546,4 @@ Comments support nested threading:
</Accordion>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -70,4 +70,4 @@ Community-created Dune dashboards of Polymarket on-chain analytics:
| Polymarket Builders Dashboard | [@defioasis](https://x.com/defioasis) | [View Dashboard](https://dune.com/gateresearch/pmbuilders) |
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -213,4 +213,4 @@ For existing Magic Link users from Polymarket.com:
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -213,4 +213,4 @@ For existing Magic Link users from Polymarket.com:
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+15 -15
View File
@@ -27,18 +27,18 @@ The Builder Program uses a tiered system to manage rate limits while rewarding h
## Tier Comparison
| Feature | Unverified | Verified | Partner |
| --------------------------- | :--------: | :-------: | :-------: |
| **Daily Relayer Txn Limit** | 100/day | 3,000/day | Unlimited |
| **API Rate Limits** | Standard | Standard | Highest |
| **Gasless Trading**\* | Yes | Yes | Yes |
| **Order Attribution** | Yes | Yes | Yes |
| **Builder Fees** | Yes | Yes | Yes |
| **Leaderboard Visibility** | — | Yes | Yes |
| **Telegram Channel** | — | Yes | Yes |
| **Engineering Support** | — | Standard | Elevated |
| **Marketing Support** | — | Standard | Elevated |
| **Priority Access** | — | — | Yes |
| Feature | Unverified | Verified | Partner |
| --------------------------- | :--------: | :--------: | :-------: |
| **Daily Relayer Txn Limit** | 100/day | 10,000/day | Unlimited |
| **API Rate Limits** | Standard | Standard | Highest |
| **Gasless Trading**\* | Yes | Yes | Yes |
| **Order Attribution** | Yes | Yes | Yes |
| **Builder Fees** | Yes | Yes | Yes |
| **Leaderboard Visibility** | — | Yes | Yes |
| **Telegram Channel** | — | Yes | Yes |
| **Engineering Support** | — | Standard | Elevated |
| **Marketing Support** | — | Standard | Elevated |
| **Priority Access** | — | — | Yes |
***
@@ -66,7 +66,7 @@ The Builder Program uses a tiered system to manage rate limits while rewarding h
## Verified
<Card title="3,000 Relay transactions/day" icon="badge-check">
<Card title="10,000 Relay transactions/day" icon="badge-check">
For builders who need higher throughput. Requires manual approval.
</Card>
@@ -81,7 +81,7 @@ Contact us at [builder@polymarket.com](mailto:builder@polymarket.com) with:
**Unlocks over Unverified:**
* 30x daily Relayer transaction limit
* 100x daily Relayer transaction limit
* Monetize with Builder fees
* Leaderboard visibility at [builders.polymarket.com](https://builders.polymarket.com)
* Private Telegram channel for announcements and support
@@ -170,4 +170,4 @@ Ready to upgrade or have questions?
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -213,4 +213,4 @@ For existing Magic Link users from Polymarket.com:
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -391,4 +391,4 @@ After revoking, generate new credentials from your [Builder Profile](https://pol
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -577,4 +577,4 @@ See [Contract Addresses](/resources/contract-addresses) for all Polymarket smart
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -153,11 +153,7 @@ curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=50&
<Card title="API Reference" icon="code" href="/api-reference/introduction">
Full endpoint documentation with parameters and response schemas.
</Card>
<Card title="Subgraph" icon="share-nodes" href="/market-data/subgraph">
Query onchain data directly from the Polymarket subgraph.
</Card>
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -108,4 +108,4 @@ Specifically for sports markets, outstanding limit orders are **automatically ca
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -111,4 +111,4 @@ Endpoints are split across three APIs. See the [API Reference](/api-reference/in
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -5
View File
@@ -153,11 +153,7 @@ curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=50&
<Card title="API Reference" icon="code" href="/api-reference/introduction">
Full endpoint documentation with parameters and response schemas.
</Card>
<Card title="Subgraph" icon="share-nodes" href="/market-data/subgraph">
Query onchain data directly from the Polymarket subgraph.
</Card>
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -83,4 +83,4 @@ Market makers are essential to Polymarket's ecosystem — they provide liquidity
For market maker onboarding and support, contact [support@polymarket.com](mailto:support@polymarket.com).
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -227,4 +227,4 @@ Before you can start market making, you need to complete these one-time setup st
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -105,4 +105,4 @@ If you deposited the wrong token on Ethereum or Polygon, use these tools to reco
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -145,4 +145,4 @@ The conversion operation is atomic and happens through the Neg Risk Adapter:
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -424,4 +424,4 @@ When initializing the L2 client, you must specify your wallet **signatureType**
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -151,4 +151,4 @@ Clarifications:
</CardGroup>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -215,4 +215,4 @@ Game status values vary by sport:
| `cancelled` | Match canceled |
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -1
View File
@@ -215,4 +215,4 @@ Game status values vary by sport:
| `cancelled` | Match canceled |
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
@@ -215,4 +215,4 @@ Game status values vary by sport:
| `cancelled` | Match canceled |
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
+1 -100
View File
@@ -1,100 +1 @@
> ## 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.
# Subgraph
> Query onchain Polymarket data using GraphQL
Polymarket's subgraphs provide indexed onchain data via GraphQL. Use them to query positions, volume, liquidity data, orders, activity, and market data.
## Available Subgraphs
| Subgraph | Description | Endpoint |
| ----------------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Positions** | User token balances | [GraphQL Playground](https://api.goldsky.com/api/public/project_cl6mb8i9h0003e201j6li0diw/subgraphs/positions-subgraph/0.0.7/gn) |
| **Orders** | Order book and trade events | [GraphQL Playground](https://api.goldsky.com/api/public/project_cl6mb8i9h0003e201j6li0diw/subgraphs/orderbook-subgraph/0.0.1/gn) |
| **Activity** | Splits, merges, redemptions | [GraphQL Playground](https://api.goldsky.com/api/public/project_cl6mb8i9h0003e201j6li0diw/subgraphs/activity-subgraph/0.0.4/gn) |
| **Open Interest** | Market and global OI | [GraphQL Playground](https://api.goldsky.com/api/public/project_cl6mb8i9h0003e201j6li0diw/subgraphs/oi-subgraph/0.0.6/gn) |
| **PNL** | User position P\&L | [GraphQL Playground](https://api.goldsky.com/api/public/project_cl6mb8i9h0003e201j6li0diw/subgraphs/pnl-subgraph/0.0.14/gn) |
<Note>
Subgraphs are hosted by [Goldsky](https://goldsky.com). Each endpoint includes
an interactive GraphQL playground for exploring the schema.
</Note>
## Querying
Send GraphQL queries via POST request to any subgraph endpoint.
```bash theme={null}
curl -X POST \
https://api.goldsky.com/api/public/project_cl6mb8i9h0003e201j6li0diw/subgraphs/orderbook-subgraph/0.0.1/gn \
-H "Content-Type: application/json" \
-d '{
"query": "query MyQuery { orderbooks { id tradesQuantity } }"
}'
```
## Schema Reference
### Positions
| Query | Description |
| ---------------------------------------- | ------------------------------ |
| `userBalance` / `userBalances` | User token balances |
| `netUserBalance` / `netUserBalances` | Aggregated net balances |
| `tokenIdCondition` / `tokenIdConditions` | Token ID to condition mappings |
| `condition` / `conditions` | Market conditions |
### Orders
| Query | Description |
| ---------------------------------------------- | ----------------------- |
| `marketData` / `marketDatas` | Market-level data |
| `orderFilledEvent` / `orderFilledEvents` | Order fill events |
| `ordersMatchedEvent` / `ordersMatchedEvents` | Order match events |
| `orderbook` / `orderbooks` | Orderbook state |
| `ordersMatchedGlobal` / `ordersMatchedGlobals` | Global match statistics |
### Activity
| Query | Description |
| ------------------------------------------------------ | -------------------- |
| `split` / `splits` | USDC to token splits |
| `merge` / `merges` | Token to USDC merges |
| `redemption` / `redemptions` | Position redemptions |
| `negRiskConversion` / `negRiskConversions` | Neg risk conversions |
| `negRiskEvent` / `negRiskEvents` | Neg risk event data |
| `fixedProductMarketMaker` / `fixedProductMarketMakers` | FPMM data |
| `position` / `positions` | Position records |
| `condition` / `conditions` | Market conditions |
### Open Interest
| Query | Description |
| -------------------------------------------- | ------------------------ |
| `condition` / `conditions` | Market conditions |
| `negRiskEvent` / `negRiskEvents` | Neg risk event data |
| `marketOpenInterest` / `marketOpenInterests` | Per-market open interest |
| `globalOpenInterest` / `globalOpenInterests` | Global open interest |
### PNL
| Query | Description |
| -------------------------------- | ------------------------------- |
| `userPosition` / `userPositions` | User position P\&L data |
| `negRiskEvent` / `negRiskEvents` | Neg risk event data |
| `condition` / `conditions` | Market conditions |
| `fpmm` / `fpmms` | Fixed product market maker data |
## Source Code
The subgraph is open source. Review the schema and mappings on GitHub:
<Card title="polymarket-subgraph" icon="github" href="https://github.com/Polymarket/polymarket-subgraph">
View source code, schema definitions, and deployment configuration.
</Card>
Built with [Mintlify](https://mintlify.com).
null