Blockchain Data API 接口参考

概述

用这份 Blockchain Data API 参考构造 REST 请求，查询已索引的区块、交易、地址、代币、NFT、DEX 活动、代币化股票与数据集新鲜度。选择数据集、检查链支持情况时先看数据集目录；查询钱包代币余额与转账历史时参考钱包资产教程。

• 基础 URL：https://api.blockvectra.com/v1/data——除 /chains 外，所有路由都以链标识为前缀（如 https://api.blockvectra.com/v1/data/{chain}/…）
• 协议：HTTP GET（批量查代币元数据 /{chain}/tokens:batch 用 POST），JSON 响应
• 认证：需要 API key——在请求头 x-api-key 中传入你的 key。请求按 CU 计量与计费，仅对 2xx 成功响应计费
• 以太坊：数据覆盖以 GET /v1/data/chains 的 coverage.from_block 为准，可用数据集也更少，见支持的链 → 以太坊
• TypeScript SDK (GitHub) · DEX 日价示例 · npm · WETH/USDG · robinhood_mainnet · 2026-10-01 UTC · JSON

npm install @blockvectra/data-api

需要按游标续传历史？带检查点的 ERC-20 转账示例每次运行保存一页及该页原始 meta；用相同的固定查询和状态文件重跑，即从原来的 opaque cursor 继续。分页耗尽不等于历史完整，请另行核对 coverage。仅支持 ERC-20。安装预构建包即可直接运行，无需本地生成 schema 或从源码编译。

Data API 各操作的 CU 权重列于定价页，也可通过 GET /v1/plans 接口获取。具体请求与响应示例请参考快速上手 → 调用 Data API。关于路径版本、向后兼容规则与对接建议，请参阅 API 版本与兼容性。

链

Data API 按链提供索引数据：https://api.blockvectra.com/v1/data/{chain}/…。

各链支持的数据集与特性因链而异，完整支持矩阵见支持的链。GET https://api.blockvectra.com/v1/data/chains 会返回每条链的 features、coverage、finality 与 limits。请求超出数据集覆盖范围时返回 HTTP 422 no_coverage（不计费）；请求未知或未公开的链名返回 HTTP 404，error.code 为 not_found（不计费；链名必须为全小写 slug）。

错误

每个错误响应都是 {"error":{"code","message"}}；只有 409 not_indexed_yet 可能额外带 indexed_through（该链已索引到的最高区块）；当整条链尚无任何索引数据时该字段不存在。客户最常遇到的错误码：

接口一览