用途：通过 The Graph 去中心化网络的 GraphQL API 查询 Uniswap v4 的链上索引数据。托管服务端点已弃用，需使用网关 URL 配合 Studio API Key。
主要能力：查询 poolManager 全局指标（池数量、交易数、交易量、TVL、费用）、池状态（流动性、sqrtPrice、tick、feeTier、hooks、交易量）、代币聚合、单笔交易、仓位（NFT tokenId 及订阅/转移事件）、PoolDayData/PoolHourData 与 TokenDayData/TokenHourData 时间序列、ModifyLiquidity 事件，并支持按区块号做历史查询。
与 v3 的关键差异：全局指标来自 poolManager 而非 factory；池 id 是池键（代币、费率、tick 间距、hooks）的 bytes32 哈希，而非已部署池合约地址；池实体包含 hooks；仓位跟踪订阅、取消订阅和转移，而非 v3 的 mint/burn/collect 模型。
使用方式：设置环境变量 export THEGRAPH_API_KEY="..."（密钥来自 https://thegraph.com/studio/apikeys/），切勿硬编码。端点模板为 https://gateway.thegraph.com/api/<THEGRAPH_API_KEY>/subgraphs/id/DiYPVdygkfjDWhbxGSqAQxwBKmfKnkWQojqeM2rkLb3G。用 curl 以 POST 发送 GraphQL 查询，可用 jq 解析；也可用 Authorization: Bearer 头。网关返回 access-control-allow-origin: *，浏览器 fetch 可直接调用，但密钥会暴露，勿在公开页面嵌入高配额密钥。分页上限 1000 条，用 first + skip 递增。
适用场景：查询以太坊主网等链上 v4 分析数据。主网 PoolManager 为 0x000000000004444c5dc75cb358380d2e3de08a90；其他链地址不同，需从 v4 Deployments 或仓库 networks.json 解析。
限制：公开浏览器链接与网关 ID 多为社区部署，非 Uniswap Labs 官方生产索引器，使用前需确认索引状态、schema 与链/合约一致，生产环境建议从官方 v4-subgraph 仓库部署。World Chain 使用私有 Goldsky 部署，无公开子图 id；Gnosis 未部署 v4。本技能不覆盖 v2/v3 子图、链上合约调用/SDK 兑换、官方应用使用的私有索引器，以及子图的部署与维护。数据仅供参考，不构成投资建议。