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/market-data/fetching-markets.md
+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).
docs/market-data/overview.md
+1 -1
View File
@@ -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).
docs/market-data/subgraph.md
+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
docs/market-data/websocket/market-channel.md
+21 -3
View File
@@ -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).
docs/market-data/websocket/overview.md
+1 -1
View File
@@ -181,4 +181,4 @@ pong
</Accordion>
Built with [Mintlify](https://mintlify.com).
Built with [Mintlify](https://mintlify.com).
docs/market-data/websocket/rtds.md
+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).
docs/market-data/websocket/sports.md
+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).