SuperAPI AI 工具集

data-availability

数据与分析

查看项目

更新于 10-27 03:33

技能介绍

该技能提供多链数据可用性能力(SQD),通过网关 https://gateway.usebuy.ai/sqd 查询 113+ 条网络的链上原始和解码数据。网关把请求代理到去中心化 SQD Network(原 Subsquid)Portal,提供高吞吐的历史与实时数据访问,无需节点基础设施、归档节点或链专属 RPC 提供商。与 /v1/ 下的付费 API 不同,/sqd/ 端点完全免费:没有 x402 支付挑战、无需签名、不需要代币。

主要约束:免费使用,不要对 /sqd/* 路由调用 buy_pay_quote 或 buy curl,使用普通 curl 或标准 HTTP fetch 即可;免费层按客户端 IP 执行令牌桶限流,每分钟 120 次请求、突发 20 次,若返回 HTTP 429 应读取 Retry-After 头并等待后重试;仅支持有界区块范围的临时查询(fromBlock、toBlock),不要发起长连接持久流或 webhook;涉及支付核验、充值跟踪或财务审计时,应使用 /finalized-stream 或 /finalized-head 而非未最终化端点,以避免重组回滚;/stream 与 /finalized-stream 返回 NDJSON(逐行独立 JSON 对象),需逐行解析;fields 参数只返回指定字段,应明确列出所需字段。

可用网络包括:EVM 100+ 条链(ethereum-mainnet、arbitrum-one、base-mainnet、optimism-mainnet、polygon-mainnet、binance-mainnet、avalanche-mainnet、berachain-mainnet、blast-l2-mainnet、celo-mainnet、linea-mainnet、scroll-mainnet、abstract-mainnet、gnosis-mainnet 及测试网等)、Solana(solana-mainnet、solana-devnet)、Bitcoin(bitcoin-mainnet)、Tron(tron-mainnet)、DEX/永续(hyperliquid-fills、hyperliquid-replica-cmds)、Substrate/Polkadot(bittensor、astar-substrate、asset-hub-polkadot、asset-hub-kusama)。可通过 GET https://gateway.usebuy.ai/sqd/datasets 动态列出全部数据集。

核心端点均以 https://gateway.usebuy.ai/sqd/datasets/{dataset} 为基址:GET /sqd/datasets 列出全部数据集及实时状态;GET /metadata 获取数据集元数据(起始区块、别名、状态);GET /head 获取最新未最终化区块号与哈希;GET /finalized-head 获取最新最终化区块(可用于结算);GET /timestamps/{timestamp}/block 将 Unix 时间戳(秒)解析为不早于该时间戳的首个区块;POST /stream 跨区块、日志、交易、指令进行临时查询;POST /finalized-stream 仅查询最终化区块,零重组风险。

典型用途包括:核验 EVM 上的 ERC-20 转账(如 Arbitrum 或 Base 上的 USDC);核验 Solana 的 SPL 代币余额变动或按程序 ID 查询指令(如 Orca、Raydium、SPL Token);查询任意 EVM 链上某地址的交易历史;按 Unix 时间戳解析以太坊或 Solana 对应区块或槽位;查询链的最终化头部。返回结果需按 NDJSON 逐行解析为 JSON 对象。

错误处理:400 invalid_request 表示 JSON 格式错误或未知字段选择器,需对照 SQD schema 检查 fields 与过滤键;404 not_found 表示未知数据集名,可查 GET /sqd/datasets;405 method_not_allowed 表示方法不允许,/sqd/* 仅支持 GET 和 POST;413 body_too_large 表示请求体超过 64 KB 限制,需缩小过滤列表或拆分查询;429 rate_limited 表示超过每分钟 120 次或突发 20 次上限,读取 Retry-After 后重试;502 bad_gateway 表示上游 SQD 网络暂时不可达,建议指数退避重试。适用场景为链上数据查询、对账核验与历史数据提取;限制在于仅支持有界范围临时查询、存在 IP 限流、请求体上限 64 KB、不提供持久流或 webhook。