Skip to main content
Polymarket’s subgraphs provide indexed onchain data via GraphQL. Use them to query positions, volume, liquidity data, orders, activity, and market data.

​
Available Subgraphs

SubgraphDescriptionEndpoint
PositionsUser token balancesGraphQL Playground
OrdersOrder book and trade eventsGraphQL Playground
ActivitySplits, merges, redemptionsGraphQL Playground
Open InterestMarket and global OIGraphQL Playground
PNLUser position P&LGraphQL Playground
Subgraphs are hosted by Goldsky. Each endpoint includes an interactive GraphQL playground for exploring the schema.

​
Querying

Send GraphQL queries via POST request to any subgraph endpoint. 
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

QueryDescription
userBalance / userBalancesUser token balances
netUserBalance / netUserBalancesAggregated net balances
tokenIdCondition / tokenIdConditionsToken ID to condition mappings
condition / conditionsMarket conditions

​
Orders

QueryDescription
marketData / marketDatasMarket-level data
orderFilledEvent / orderFilledEventsOrder fill events
ordersMatchedEvent / ordersMatchedEventsOrder match events
orderbook / orderbooksOrderbook state
ordersMatchedGlobal / ordersMatchedGlobalsGlobal match statistics

​
Activity

QueryDescription
split / splitsUSDC to token splits
merge / mergesToken to USDC merges
redemption / redemptionsPosition redemptions
negRiskConversion / negRiskConversionsNeg risk conversions
negRiskEvent / negRiskEventsNeg risk event data
fixedProductMarketMaker / fixedProductMarketMakersFPMM data
position / positionsPosition records
condition / conditionsMarket conditions

​
Open Interest

QueryDescription
condition / conditionsMarket conditions
negRiskEvent / negRiskEventsNeg risk event data
marketOpenInterest / marketOpenInterestsPer-market open interest
globalOpenInterest / globalOpenInterestsGlobal open interest

​
PNL

QueryDescription
userPosition / userPositionsUser position P&L data
negRiskEvent / negRiskEventsNeg risk event data
condition / conditionsMarket conditions
fpmm / fpmmsFixed product market maker data

​
Source Code

The subgraph is open source. Review the schema and mappings on GitHub:

polymarket-subgraph

View source code, schema definitions, and deployment configuration.