Data API

概述复制锚点链接

Data API 提供了 REST 端点来查询区块链索引数据——区块、交易、地址、代币、NFT、DEX 活动、代币化股票和数据集新鲜度。

• 基础 URL：https://dev-api.blockvectra.network/v1/data——除 /chains 外，所有路由都以链标识为前缀（如 https://dev-api.blockvectra.network/v1/data/{chain}/…）
• 协议：HTTP GET（批量查代币元数据 /{chain}/tokens:batch 用 POST），JSON 响应
• 认证：需要 API key——在请求头 x-api-key 中传入你的 key。请求按 CU 计量与计费，仅对 2xx 成功响应计费
• 以太坊（Beta）：只提供最近约 30 天的数据，可用数据集也更少，见支持的链 → 以太坊

Data API 各操作的 CU 权重列于定价页，也可通过 GET /v1/plans 接口获取。具体请求与响应示例请参考快速上手 → 调用 Data API。

链复制锚点链接

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

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

错误复制锚点链接

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

409 not_indexed_yet 覆盖两种情况。区块高于已索引链头：请求的区块号高于该链已索引的高度，响应带 indexed_through，数据之后可能到位，稍后重试即可。尚无任何索引数据：刚上线的链没有任何已索引数据，响应不带 indexed_through，且 GET /v1/data/chains 中该链的 coverage.has_data 为 false。此时等待该链开始索引即可；可通过 /v1/status 的 data_status 或 /v1/data/chains 的 coverage.has_data 查看当前状态，开始索引后这些值会自动变化。

仅 2xx 响应计费，错误响应一律不计费。