用 The Graph 的 Subgraph 高效查询 Polymarket 链上数据全攻略

为什么用 Subgraph 查询 Polymarket？

Polymarket 作为领先的去中心化预测市场，每天都有海量事件、交易和结算数据沉淀在链上。与其自建节点做全量同步，不如直接调用 Subgraph——The Graph 网络提供的开源、去中心化索引层，让开发者用 GraphQL 一句话拿到所需的链上洞见，省时又省 gas。

核心关键词：Polymarket 数据查询、Subgraph、The Graph、GraphQL、链上索引、预测市场 API、Arbitrum 数据、区块链查询教程

快速上手：Graph Explorer 交互式操作

打开 Polymarket 在 Graph Explorer 的页面，左侧就是 可视化的 GraphiQL Playground。无需 IDE，直接点选字段即可拼装查询，右边实时返回 JSON 结果，对新手极为友好。

可视化编辑器一步拆解

选择字段 ➡ 自动生成查询

GraphiQL 列出所有 Entity（如 redemptions、positions、markets 等），点击字段即可加入查询。系统帮你补全括号、参数，彻底告别手工拼 SQL。

案例：找出历史前五的最高赔付事件

把 redemptions 作为主体，排序字段 payout 设定为 desc，再加 first: 5 就只取头部 5 条，瞬间抓住“赢家”：

{
  redemptions(
    orderBy: payout,
    orderDirection: desc,
    first: 5
  ) {
    payout
    redeemer
    id
    timestamp
  }
}

示例输出片段（数值均已链上原生格式展示，单位 10⁻⁶ USDC）：

{
  "data": {
    "redemptions": [
      {
        "id": "0x8fbb...7d1_0x3b",
        "payout": "6274509531681",
        "redeemer": "0xfffe4013adfe325c6e02d36dc66e091f5476f52c",
        "timestamp": "1722929672"
      },
      ...
    ]
  }
}

读懂 Polymarket Subgraph Schema

Subgraph 的真正魅力在于 Schema 就是文档。所有实体、关系和字段定义都可以在 GitHub 官方仓库自检，无需逐行看合约源码。
常见高频实体速查：

Market：预测事件本身
Position：用户的具体押注
Trade：任何一次买卖记录
Redemption：结算后提取收益

获取专属 API Key，免费额度先用先爽

打开 The Graph Studio，连接钱包一键登录
进入 API Keys 页面，点击 Create API Key

👉 每月十万次免费查询，项目快起步就现在

该 API Key 对所有 Subgraph 通用，做 side project 绰绰有余；正式上线后再按量付费即可。

一行代码串起链下应用

有了 endpoint，前端或脚本都能秒调：

const axios = require('axios');

const query = `
{
  markets(first: 10, orderBy: volume, orderDirection: desc) {
    id
    question
    volume
    outcomePrices
  }
}`;

const endpoint = 'https://gateway.thegraph.com/api/{api-key}/subgraphs/id/Bx1W4S7kDVxs9gC3s2G6DS8kdNBJNVhMviCtin2DiBp';

axios.post(endpoint, { query })
  .then(res => console.log(res.data.data))
  .catch(console.error);

替换 {api-key} 后即可在 Node、浏览器或 Serverless 环境中跑通。10 行代码顶一套后端索引服务。

Polymarket 完整 Subgraph 清单

场景	链接（Explorer）
主活动数据	查看实时交易量、事件状态
Polygon 版本历史	早期数据溯源
盈亏分析	追踪钱包级收益
未平仓量	做流动性与风险评估

（为保护排版，请直接在 Explorer 搜索对应名称即可定位）

高阶玩法：自建 Subgraph 还是直接复用？

复用官方 Subgraph：90% 场景覆盖，维护省心
自建 Subgraph：需要组合额外合约日志、在高度定制场景提升查询性能
详细文档指路 👉 官方开发指南

FAQ：你可能还想问

Q1：查询频率有限制吗？
A：100 k 次免费额度按自然月重置，超出后按量梯度计费，价格公开可查。正式环境建议加简单缓存，减少重复请求。

Q2：返回的单位是什么？
A：Polymarket 大量使用 6 位小数的 USDC 精度，客户端需自行除以 1,000,000。“6274509531681” ≈ 6,274,509.53 USDC。

Q3：能追溯多久以前的数据？
A：Subgraph 从部署区块即开始索引，大致覆盖 2022-06 至今全部交易，数据完整性可与链上核对。

Q4：低代码或零代码能接入吗？
A：当然，很多 BI 工具（如 Dune、Nansen Query）已内置 The Graph endpoint，图形化拖字段即可。

进阶场景示例

监控巨鲸动向：监听 Trades 表，对单笔交易额 > $50 k 的地址发送 Telegram 告警
实时排行榜：以 markets.volume 为排序，每隔 5 秒轮询，展示当前最火预测
组合策略回测：抓 Redemption 历史，结合 Trade 计算盈亏，验证“均值回归”策略

结语：让数据为预测赋能

通过 Subgraph 查询 Polymarket，开发者几分钟即可掌握预测市场脉搏，无需重跑区块、无需写复杂解析脚本。
准备好把洞察落地？先拿免费 API Key 跑一段代码，再根据业务深度决定是继续拼装链下逻辑 👉 还是从零打造专属 Subgraph。链上百万级实时数据，等待你的下一个创新。