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

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

Browse Source
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
Download Patch File Download Diff File Expand all files Collapse all files
docs/api-reference/events/get-event-by-id.md
+20
View File
@@ -818,6 +818,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
Series: Series:
type: object type: object
properties: properties:
@@ -1189,6 +1194,21 @@ components:
outcomes: outcomes:
type: string type: string
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
```` ````
docs/api-reference/events/get-event-by-slug.md
+20
View File
@@ -818,6 +818,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
Series: Series:
type: object type: object
properties: properties:
@@ -1189,6 +1194,21 @@ components:
outcomes: outcomes:
type: string type: string
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
```` ````
docs/api-reference/events/list-events.md
+20
View File
@@ -928,6 +928,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
Series: Series:
type: object type: object
properties: properties:
@@ -1299,6 +1304,21 @@ components:
outcomes: outcomes:
type: string type: string
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
```` ````
docs/api-reference/markets/get-market-by-id.md
+20
View File
@@ -493,6 +493,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
ImageOptimization: ImageOptimization:
type: object type: object
properties: properties:
@@ -882,6 +887,21 @@ components:
isCarousel: isCarousel:
type: boolean type: boolean
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
Series: Series:
type: object type: object
properties: properties:
docs/api-reference/markets/get-market-by-slug.md
+20
View File
@@ -493,6 +493,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
ImageOptimization: ImageOptimization:
type: object type: object
properties: properties:
@@ -882,6 +887,21 @@ components:
isCarousel: isCarousel:
type: boolean type: boolean
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
Series: Series:
type: object type: object
properties: properties:
docs/api-reference/markets/list-markets.md
+20
View File
@@ -619,6 +619,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
ImageOptimization: ImageOptimization:
type: object type: object
properties: properties:
@@ -1008,6 +1013,21 @@ components:
isCarousel: isCarousel:
type: boolean type: boolean
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
Series: Series:
type: object type: object
properties: properties:
docs/api-reference/search/search-markets-events-and-profiles.md
+20
View File
@@ -972,6 +972,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
Series: Series:
type: object type: object
properties: properties:
@@ -1343,6 +1348,21 @@ components:
outcomes: outcomes:
type: string type: string
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
```` ````
docs/api-reference/series/get-series-by-id.md
+20
View File
@@ -1122,6 +1122,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
EventCreator: EventCreator:
type: object type: object
properties: properties:
@@ -1185,6 +1190,21 @@ components:
outcomes: outcomes:
type: string type: string
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
```` ````
docs/api-reference/series/list-series.md
+20
View File
@@ -1172,6 +1172,11 @@ components:
type: string type: string
format: date-time format: date-time
nullable: true nullable: true
feesEnabled:
type: boolean
nullable: true
feeSchedule:
$ref: '#/components/schemas/FeeSchedule'
EventCreator: EventCreator:
type: object type: object
properties: properties:
@@ -1235,6 +1240,21 @@ components:
outcomes: outcomes:
type: string type: string
nullable: true nullable: true
FeeSchedule:
type: object
properties:
exponent:
type: number
nullable: true
rate:
type: number
nullable: true
takerOnly:
type: boolean
nullable: true
rebateRate:
type: number
nullable: true
```` ````
docs/api-reference/trade/get-user-orders.md
+2 -2
View File
@@ -12,7 +12,7 @@ Builder-authenticated clients can also use this endpoint to retrieve orders attr
## OpenAPI ## OpenAPI
````yaml /api-spec/clob-openapi.yaml get /orders ````yaml /api-spec/clob-openapi.yaml get /data/orders
openapi: 3.1.0 openapi: 3.1.0
info: info:
title: Polymarket CLOB API title: Polymarket CLOB API
@@ -41,7 +41,7 @@ tags:
- name: Rebates - name: Rebates
description: Maker rebate endpoints description: Maker rebate endpoints
paths: paths:
/orders: /data/orders:
get: get:
tags: tags:
- Trade - Trade
docs/builders/tiers.md
+14 -14
View File
@@ -27,18 +27,18 @@ The Builder Program uses a tiered system to manage rate limits while rewarding h
## Tier Comparison ## Tier Comparison
| Feature | Unverified | Verified | Partner | | Feature | Unverified | Verified | Partner |
| --------------------------- | :--------: | :-------: | :-------: | | --------------------------- | :--------: | :--------: | :-------: |
| **Daily Relayer Txn Limit** | 100/day | 3,000/day | Unlimited | | **Daily Relayer Txn Limit** | 100/day | 10,000/day | Unlimited |
| **API Rate Limits** | Standard | Standard | Highest | | **API Rate Limits** | Standard | Standard | Highest |
| **Gasless Trading**\* | Yes | Yes | Yes | | **Gasless Trading**\* | Yes | Yes | Yes |
| **Order Attribution** | Yes | Yes | Yes | | **Order Attribution** | Yes | Yes | Yes |
| **Builder Fees** | Yes | Yes | Yes | | **Builder Fees** | Yes | Yes | Yes |
| **Leaderboard Visibility** | — | Yes | Yes | | **Leaderboard Visibility** | — | Yes | Yes |
| **Telegram Channel** | — | Yes | Yes | | **Telegram Channel** | — | Yes | Yes |
| **Engineering Support** | — | Standard | Elevated | | **Engineering Support** | — | Standard | Elevated |
| **Marketing Support** | — | Standard | Elevated | | **Marketing Support** | — | Standard | Elevated |
| **Priority Access** | — | — | Yes | | **Priority Access** | — | — | Yes |
*** ***
@@ -66,7 +66,7 @@ The Builder Program uses a tiered system to manage rate limits while rewarding h
## Verified ## 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. For builders who need higher throughput. Requires manual approval.
</Card> </Card>
@@ -81,7 +81,7 @@ Contact us at [builder@polymarket.com](mailto:builder@polymarket.com) with:
**Unlocks over Unverified:** **Unlocks over Unverified:**
* 30x daily Relayer transaction limit * 100x daily Relayer transaction limit
* Monetize with Builder fees * Monetize with Builder fees
* Leaderboard visibility at [builders.polymarket.com](https://builders.polymarket.com) * Leaderboard visibility at [builders.polymarket.com](https://builders.polymarket.com)
* Private Telegram channel for announcements and support * Private Telegram channel for announcements and support
docs/developers/CLOB/status.md
+3 -3
View File
File diff suppressed because one or more lines are too long
docs/developers/CLOB/websocket/market-channel.md
+20 -2
View File
@@ -146,7 +146,17 @@ Emitted when a new market is created.
The payload also includes market metadata fields such as `tags`, The payload also includes market metadata fields such as `tags`,
`condition_id`, `active`, `clob_token_ids`, `sports_market_type`, `line`, `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} ```json theme={null}
{ {
@@ -180,7 +190,15 @@ The payload also includes market metadata fields such as `tags`,
"line": "", "line": "",
"game_start_time": "", "game_start_time": "",
"order_price_min_tick_size": "0.01", "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"
}
} }
``` ```
docs/developers/builders/builder-tiers.md
+14 -14
View File
@@ -27,18 +27,18 @@ The Builder Program uses a tiered system to manage rate limits while rewarding h
## Tier Comparison ## Tier Comparison
| Feature | Unverified | Verified | Partner | | Feature | Unverified | Verified | Partner |
| --------------------------- | :--------: | :-------: | :-------: | | --------------------------- | :--------: | :--------: | :-------: |
| **Daily Relayer Txn Limit** | 100/day | 3,000/day | Unlimited | | **Daily Relayer Txn Limit** | 100/day | 10,000/day | Unlimited |
| **API Rate Limits** | Standard | Standard | Highest | | **API Rate Limits** | Standard | Standard | Highest |
| **Gasless Trading**\* | Yes | Yes | Yes | | **Gasless Trading**\* | Yes | Yes | Yes |
| **Order Attribution** | Yes | Yes | Yes | | **Order Attribution** | Yes | Yes | Yes |
| **Builder Fees** | Yes | Yes | Yes | | **Builder Fees** | Yes | Yes | Yes |
| **Leaderboard Visibility** | — | Yes | Yes | | **Leaderboard Visibility** | — | Yes | Yes |
| **Telegram Channel** | — | Yes | Yes | | **Telegram Channel** | — | Yes | Yes |
| **Engineering Support** | — | Standard | Elevated | | **Engineering Support** | — | Standard | Elevated |
| **Marketing Support** | — | Standard | Elevated | | **Marketing Support** | — | Standard | Elevated |
| **Priority Access** | — | — | Yes | | **Priority Access** | — | — | Yes |
*** ***
@@ -66,7 +66,7 @@ The Builder Program uses a tiered system to manage rate limits while rewarding h
## Verified ## 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. For builders who need higher throughput. Requires manual approval.
</Card> </Card>
@@ -81,7 +81,7 @@ Contact us at [builder@polymarket.com](mailto:builder@polymarket.com) with:
**Unlocks over Unverified:** **Unlocks over Unverified:**
* 30x daily Relayer transaction limit * 100x daily Relayer transaction limit
* Monetize with Builder fees * Monetize with Builder fees
* Leaderboard visibility at [builders.polymarket.com](https://builders.polymarket.com) * Leaderboard visibility at [builders.polymarket.com](https://builders.polymarket.com)
* Private Telegram channel for announcements and support * Private Telegram channel for announcements and support
docs/developers/gamma-markets-api/fetch-markets-guide.md
-4
View File
@@ -153,10 +153,6 @@ curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=50&
<Card title="API Reference" icon="code" href="/api-reference/introduction"> <Card title="API Reference" icon="code" href="/api-reference/introduction">
Full endpoint documentation with parameters and response schemas. Full endpoint documentation with parameters and response schemas.
</Card> </Card>
<Card title="Subgraph" icon="share-nodes" href="/market-data/subgraph">
Query onchain data directly from the Polymarket subgraph.
</Card>
</CardGroup> </CardGroup>
docs/developers/market-makers/data-feeds.md
-4
View File
@@ -153,10 +153,6 @@ curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=50&
<Card title="API Reference" icon="code" href="/api-reference/introduction"> <Card title="API Reference" icon="code" href="/api-reference/introduction">
Full endpoint documentation with parameters and response schemas. Full endpoint documentation with parameters and response schemas.
</Card> </Card>
<Card title="Subgraph" icon="share-nodes" href="/market-data/subgraph">
Query onchain data directly from the Polymarket subgraph.
</Card>
</CardGroup> </CardGroup>
docs/developers/subgraph/overview.md
+1 -100
View File
@@ -1,100 +1 @@
> ## Documentation Index null
> 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).
docs/market-data/fetching-markets.md
-4
View File
@@ -153,10 +153,6 @@ curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=50&
<Card title="API Reference" icon="code" href="/api-reference/introduction"> <Card title="API Reference" icon="code" href="/api-reference/introduction">
Full endpoint documentation with parameters and response schemas. Full endpoint documentation with parameters and response schemas.
</Card> </Card>
<Card title="Subgraph" icon="share-nodes" href="/market-data/subgraph">
Query onchain data directly from the Polymarket subgraph.
</Card>
</CardGroup> </CardGroup>
docs/market-data/subgraph.md
+1 -100
View File
@@ -1,100 +1 @@
> ## Documentation Index null
> 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).
docs/market-data/websocket/market-channel.md
+20 -2
View File
@@ -146,7 +146,17 @@ Emitted when a new market is created.
The payload also includes market metadata fields such as `tags`, The payload also includes market metadata fields such as `tags`,
`condition_id`, `active`, `clob_token_ids`, `sports_market_type`, `line`, `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} ```json theme={null}
{ {
@@ -180,7 +190,15 @@ The payload also includes market metadata fields such as `tags`,
"line": "", "line": "",
"game_start_time": "", "game_start_time": "",
"order_price_min_tick_size": "0.01", "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"
}
} }
``` ```
docs/market-makers/liquidity-rewards.md
+208 -7
View File
@@ -26,6 +26,19 @@ The program is designed to:
*** ***
<Note>
The minimum reward payout is **\$1**; amounts below this will not be paid.
</Note>
<Tip>
Both `min_incentive_size` and `max_incentive_spread` can be fetched alongside
full market objects via the CLOB API and [Markets
API](/market-data/fetching-markets). Reward allocations for an epoch can also
be fetched via the Markets API.
</Tip>
***
## Methodology ## Methodology
Liquidity providers are rewarded based on a formula that rewards participation in markets, boosts two-sided depth (single-sided orders still score), and tighter spread vs the size-cutoff-adjusted midpoint. Each market configures a max spread and min size cutoff within which orders are considered. The average of rewards earned is determined by the relative share of each participant's Q<sub>n</sub> in market m. Liquidity providers are rewarded based on a formula that rewards participation in markets, boosts two-sided depth (single-sided orders still score), and tighter spread vs the size-cutoff-adjusted midpoint. Each market configures a max spread and min size cutoff within which orders are considered. The average of rewards earned is determined by the relative share of each participant's Q<sub>n</sub> in market m.
@@ -142,16 +155,204 @@ Q<sub>no</sub> is calculated every minute using random sampling.
*** ***
## April 2026 — Liquidity Incentive Program
Polymarket is distributing over **\$5M** in liquidity incentives for April 2026 across sports and esports markets. The reward pool is split into **Pre** (pre-game) and **Live** (in-play) periods per game. Rewards are distributed pro-rata across all eligible markets within each game.
<Note> <Note>
The minimum reward payout is **\$1**; amounts below this will not be paid. This covers April 2026 sports markets. Additional categories will be added soon.
</Note> </Note>
<Tip> ### Soccer — Top 5 Leagues + UEFA
Both `min_incentive_size` and `max_incentive_spread` can be fetched alongside
full market objects via the CLOB API and [Markets Every game in these leagues has liquidity rewards split across pre-game and live periods.
API](/market-data/fetching-markets). Reward allocations for an epoch can also
be fetched via the Markets API. | League | Pre \$/Game | Live \$/Game | Total \$/Game |
</Tip> | ----------------------- | ----------- | ------------ | ------------- |
| English Premier League | \$2,800 | \$7,200 | \$10,000 |
| La Liga | \$900 | \$2,400 | \$3,300 |
| Serie A | \$900 | \$2,400 | \$3,300 |
| Bundesliga | \$850 | \$2,150 | \$3,000 |
| Ligue 1 | \$600 | \$1,500 | \$2,100 |
| Champions League (QFs) | \$6,750 | \$17,250 | \$24,000 |
| Europa League (QFs) | \$1,350 | \$3,400 | \$4,750 |
| Conference League (QFs) | \$400 | \$1,100 | \$1,500 |
### Soccer — Americas
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| -------------------------- | ----------- | ------------ | ------------- |
| MLS | \$450 | \$1,200 | \$1,650 |
| Liga MX | \$450 | \$1,200 | \$1,650 |
| Copa Libertadores (Groups) | \$750 | \$1,900 | \$2,650 |
| Copa Sudamericana (Groups) | \$225 | \$575 | \$800 |
| Argentine Primera Division | \$150 | \$400 | \$550 |
| Brasileirao Serie A | \$150 | \$400 | \$550 |
| Colombian Primera A | \$100 | \$200 | \$300 |
| Chilean Primera Division | \$75 | \$175 | \$250 |
| Peruvian Primera Division | \$75 | \$175 | \$250 |
| Bolivian Primera | \$25 | \$50 | \$75 |
| Brasileirao Serie B | \$25 | \$50 | \$75 |
### Soccer — Other Europe
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| ------------------------ | ----------- | ------------ | ------------- |
| Turkish Super Lig | \$550 | \$1,450 | \$2,000 |
| Eredivisie | \$250 | \$650 | \$900 |
| Liga Portugal | \$200 | \$550 | \$750 |
| EFL Championship | \$150 | \$350 | \$500 |
| Russian Premier League | \$100 | \$275 | \$375 |
| Danish Superliga | \$75 | \$150 | \$225 |
| Czech First League | \$25 | \$75 | \$100 |
| Romanian Liga I | \$25 | \$75 | \$100 |
| Ukrainian Premier League | \$25 | \$75 | \$100 |
### Soccer — Asia / Middle East / Africa
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| ----------------------- | ----------- | ------------ | ------------- |
| Saudi Pro League | \$450 | \$1,200 | \$1,650 |
| J1 League (Japan) | \$300 | \$800 | \$1,100 |
| K League 1 (Korea) | \$200 | \$550 | \$750 |
| Chinese Super League | \$100 | \$250 | \$350 |
| A-League (Australia) | \$100 | \$250 | \$350 |
| Indian Super League | \$75 | \$175 | \$250 |
| J2 League (Japan) | \$25 | \$75 | \$100 |
| Egyptian Premier League | \$25 | \$75 | \$100 |
| Moroccan League | \$25 | \$75 | \$100 |
| Norwegian Eliteserien | \$25 | \$75 | \$100 |
### Soccer — Domestic Cups
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| ----------------------------- | ----------- | ------------ | ------------- |
| FA Cup (Semi-Finals) | \$850 | \$2,000 | \$2,850 |
| DFB-Pokal (Semi-Finals) | \$450 | \$950 | \$1,400 |
| Coppa Italia (Semi-Finals) | \$450 | \$950 | \$1,400 |
| Coupe de France (Semi-Finals) | \$275 | \$675 | \$950 |
### Esports — CS2
| Tier | Pre \$/Game | Live \$/Game | Total \$/Game |
| ----------------------------------- | ----------- | ------------ | ------------- |
| A Tier (ESL Pro League, BLAST) | \$1,550 | \$3,950 | \$5,500 |
| B Tier (RMRs, Large Regional) | \$1,550 | \$3,950 | \$5,500 |
| C Tier (Small Regional, Qualifiers) | \$150 | \$350 | \$500 |
### Esports — League of Legends
| Tier | Pre \$/Game | Live \$/Game | Total \$/Game |
| ------------------------------- | ----------- | ------------ | ------------- |
| A Tier (LCK, LPL, LEC Playoffs) | \$1,550 | \$3,950 | \$5,500 |
| B Tier (LCS, Other Regional) | \$1,550 | \$3,950 | \$5,500 |
| C Tier (ERLs, National Leagues) | \$150 | \$350 | \$500 |
### Esports — Dota 2
| Tier | Pre \$/Game | Live \$/Game | Total \$/Game |
| -------------------------- | ----------- | ------------ | ------------- |
| A/B Tier (DPC, Qualifiers) | \$1,000 | \$2,500 | \$3,500 |
| C Tier (Regional) | \$150 | \$350 | \$500 |
### Esports — Valorant
| Tier | Pre \$/Game | Live \$/Game | Total \$/Game |
| --------------------- | ----------- | ------------ | ------------- |
| A/B Tier (VCT Stages) | \$1,000 | \$2,500 | \$3,500 |
| C Tier (Regional) | \$150 | \$350 | \$500 |
### Esports — Other Titles
| Game | Pre \$/Game | Live \$/Game | Total \$/Game |
| ------------------------- | ----------- | ------------ | ------------- |
| Call of Duty (CDL) | \$50 | \$100 | \$150 |
| Rocket League (RLCS) | \$50 | \$100 | \$150 |
| Mobile Legends: Bang Bang | \$50 | \$100 | \$150 |
| Honor of Kings | \$50 | \$100 | \$150 |
### Basketball
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| ------------------------------------- | ----------- | ------------ | ------------- |
| NBA (Reg Season + Play-In + Playoffs) | \$2,150 | \$5,550 | \$7,700 |
| EuroLeague (Playoffs) | \$150 | \$350 | \$500 |
| ACB Spain | \$75 | \$200 | \$275 |
| Lega Basket Serie A (Italy) | \$75 | \$200 | \$275 |
| Basketball Champions League | \$75 | \$200 | \$275 |
| CBA (China) | \$50 | \$150 | \$200 |
| LNB Pro A (France) | \$50 | \$150 | \$200 |
| KBL (Korea) | \$25 | \$50 | \$75 |
| NBL (Australia) | \$25 | \$50 | \$75 |
| B.League (Japan) | \$25 | \$50 | \$75 |
| BBL (Germany) | \$25 | \$50 | \$75 |
| ABA League | \$25 | \$50 | \$75 |
| BSL (Turkey) | \$25 | \$50 | \$75 |
| Greek A1 | \$25 | \$50 | \$75 |
| LNB Argentina | \$0 | \$25 | \$25 |
| VTB United League | \$0 | \$25 | \$25 |
### Baseball
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| ----------- | ----------- | ------------ | ------------- |
| MLB | \$465 | \$1,185 | \$1,650 |
| KBO (Korea) | \$75 | \$225 | \$300 |
### Hockey
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| --------------------------- | ----------- | ------------ | ------------- |
| NHL (Reg Season + Playoffs) | \$400 | \$1,100 | \$1,500 |
| KHL (Playoffs) | \$75 | \$200 | \$275 |
| SHL (Playoffs) | \$25 | \$150 | \$175 |
| AHL | \$0 | \$25 | \$25 |
| Czech Extraliga (Playoffs) | \$0 | \$25 | \$25 |
| DEL Germany (Playoffs) | \$0 | \$25 | \$25 |
### Tennis
| Tour | Pre \$/Game | Live \$/Game | Total \$/Game |
| -------- | ----------- | ------------ | ------------- |
| ATP Tour | \$450 | \$1,000 | \$1,450 |
| WTA Tour | \$300 | \$750 | \$1,050 |
### UFC / MMA
| Event Type | Pre \$/Game | Live \$/Game | Total \$/Game |
| ------------- | ----------- | ------------ | ------------- |
| UFC Main Card | \$1,200 | \$3,050 | \$4,250 |
| UFC Prelims | \$250 | \$700 | \$950 |
### Cricket
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| ---------------------------- | ----------- | ------------ | ------------- |
| IPL (Indian Premier League) | \$1,250 | \$3,250 | \$4,500 |
| ICC ODI Internationals | \$0 | \$50 | \$50 |
| ICC T20 Internationals | \$0 | \$50 | \$50 |
| Other Cricket Internationals | \$0 | \$25 | \$25 |
| Test Cricket | \$0 | \$25 | \$25 |
### Rugby
| League | Pre \$/Game | Live \$/Game | Total \$/Game |
| ---------------------------- | ----------- | ------------ | ------------- |
| Top 14 (France) | \$75 | \$175 | \$250 |
| Premiership Rugby (England) | \$75 | \$175 | \$250 |
| Super Rugby Pacific | \$75 | \$175 | \$250 |
| United Rugby Championship | \$50 | \$125 | \$175 |
| European Champions Cup (QFs) | \$100 | \$300 | \$400 |
### Other
| Event | Pre \$/Game | Live \$/Game | Total \$/Game |
| ---------------- | ----------- | ------------ | ------------- |
| WTT Table Tennis | \$0 | \$25 | \$25 |
| Chess | \$25 | \$75 | \$100 |
| PLL Lacrosse | \$25 | \$75 | \$100 |
***
## Next Steps ## Next Steps
docs/polymarket-learn/FAQ/does-polymarket-have-an-api.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/embeds.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/how-to-export-private-key.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/is-my-money-safe.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/is-polymarket-the-house.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/polling.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/recover-missing-deposit.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/sell-early.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/polymarket-learn/FAQ/support.md
+3 -2
View File
File diff suppressed because one or more lines are too long
docs/quickstart/fetching-data.md
-4
View File
@@ -153,10 +153,6 @@ curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=50&
<Card title="API Reference" icon="code" href="/api-reference/introduction"> <Card title="API Reference" icon="code" href="/api-reference/introduction">
Full endpoint documentation with parameters and response schemas. Full endpoint documentation with parameters and response schemas.
</Card> </Card>
<Card title="Subgraph" icon="share-nodes" href="/market-data/subgraph">
Query onchain data directly from the Polymarket subgraph.
</Card>
</CardGroup> </CardGroup>