跳转到主要内容
Polymarket 的 Subgraph 通过 GraphQL 提供索引化的链上数据。你可以用它们查询持仓、交易量、流动性数据、订单、活动和市场数据。

可用的 Subgraph

Subgraph说明端点
Positions用户代币余额GraphQL Playground
Orders订单簿和交易事件GraphQL Playground
Activity拆分、合并、兑换操作GraphQL Playground
Open Interest市场和全局未平仓合约GraphQL Playground
PNL用户持仓盈亏GraphQL Playground
Subgraph 由 Goldsky 托管。每个端点都包含交互式 GraphQL Playground,方便你探索数据结构。

查询方式

向任意 Subgraph 端点发送 POST 请求即可执行 GraphQL 查询。
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 参考

Positions

查询说明
userBalance / userBalances用户代币余额
netUserBalance / netUserBalances聚合净余额
tokenIdCondition / tokenIdConditionsToken ID 与条件的映射
condition / conditions市场条件

Orders

查询说明
marketData / marketDatas市场级别数据
orderFilledEvent / orderFilledEvents订单成交事件
ordersMatchedEvent / ordersMatchedEvents订单撮合事件
orderbook / orderbooks订单簿状态
ordersMatchedGlobal / ordersMatchedGlobals全局撮合统计

Activity

查询说明
split / splitsUSDC 拆分为代币
merge / merges代币合并为 USDC
redemption / redemptions持仓兑换
negRiskConversion / negRiskConversionsNeg risk 转换
negRiskEvent / negRiskEventsNeg risk 事件数据
fixedProductMarketMaker / fixedProductMarketMakersFPMM 数据
position / positions持仓记录
condition / conditions市场条件

Open Interest

查询说明
condition / conditions市场条件
negRiskEvent / negRiskEventsNeg risk 事件数据
marketOpenInterest / marketOpenInterests单市场未平仓合约
globalOpenInterest / globalOpenInterests全局未平仓合约

PNL

查询说明
userPosition / userPositions用户持仓盈亏数据
negRiskEvent / negRiskEventsNeg risk 事件数据
condition / conditions市场条件
fpmm / fpmmsFixed product market maker 数据

源代码

Subgraph 是开源的。你可以在 GitHub 上查看 schema 和映射:

polymarket-subgraph

查看源代码、schema 定义和部署配置。