在 Base 上使用 BlockVectra

通过 BlockVectra 接入 Base 主网的 JSON-RPC：链 ID、端点、curl 与 viem 示例、方法策略以及 Data API 状态。

BlockVectra 提供 Base 主网的 JSON-RPC 访问，通过统一的 API 端点为开发者提供服务。

链信息与端点

针对 Base 的每次请求均通过 URL 路径中的 base_mainnet 标识目标链。JSON-RPC 同时支持在 URL 路径中携带 Key 以及在请求头中传入 x-api-key 两种鉴权写法。

以下参数与端点来自当前网络数据：

参数 / 端点	取值 / 模板	鉴权方式
Chain ID（EIP-155）	`8453`	无需鉴权（公开）
JSON-RPC（路径携带 Key）	`POST https://api.blockvectra.com/v1/base_mainnet/{api_key}`	URL 路径中传入 API key
JSON-RPC（请求头携带 Key）	`POST https://api.blockvectra.com/v1/base_mainnet`	传入 x-api-key: {api_key} 请求头
Data API 基址	`暂未开放`	—
公开状态端点	`GET https://api.blockvectra.com/v1/status`	无需鉴权（公开）

直接运行的 curl 与 viem 示例

可以使用 curl 或 viem 等客户端直接发起 JSON-RPC 调用。请在环境变量 BLOCKVECTRA_API_KEY 中配置你的 API key：

通过 x-api-key 请求头查询 EIP-155 链 ID：

curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

响应结构说明

接口响应严格遵循 JSON-RPC 2.0 规范：

成功响应：返回包含 jsonrpc: "2.0"、对应请求整数 id 以及十六进制编码字符串 result 的对象（eth_chainId 返回十六进制链 ID；eth_blockNumber 返回最新区块高度）。
未开放方法：请求未开放的方法返回 JSON-RPC 错误码 -32601（method not available，不计费）。
超出状态窗口：查询超出历史状态保留窗口的区块返回 JSON-RPC 错误码 -32011（不计费）。
缺失 API Key：未提供 API key 时返回 HTTP 401 与 JSON-RPC 错误码 -32024（missing_api_key，不计费）。
参数错误：请求参数格式不符合要求返回 JSON-RPC 错误码 -32602（不计费）。

支持情况与方法策略

Base 上可用的 JSON-RPC 方法、日志区块跨度上限以及历史状态保留窗口通过 GET /v1/chains 动态发布：

网络参数与调用限制

eth_getLogs 单次区块跨度: 单次最多 1000 个区块
历史状态窗口: 最近 10000 个区块（超出窗口返回 -32011）
执行追踪（debug_trace*）: 暂不支持

允许的方法列表（methods.allow）

eth_blockNumber
eth_chainId
eth_gasPrice
eth_maxPriorityFeePerGas
eth_blobBaseFee
eth_feeHistory
eth_syncing
eth_getBalance
eth_getCode
eth_getStorageAt
eth_getTransactionCount
eth_call
eth_estimateGas
eth_createAccessList
eth_getProof
eth_simulateV1
eth_getBlockByNumber
eth_getBlockByHash
eth_getBlockReceipts
eth_getBlockTransactionCountByNumber
eth_getBlockTransactionCountByHash
eth_getTransactionByHash
eth_getTransactionReceipt
eth_getTransactionByBlockNumberAndIndex
eth_getTransactionByBlockHashAndIndex
eth_getRawTransactionByHash
eth_getRawTransactionByBlockHashAndIndex
eth_getRawTransactionByBlockNumberAndIndex
eth_getLogs
eth_getUncleCountByBlockNumber
eth_getUncleCountByBlockHash
eth_getUncleByBlockNumberAndIndex
eth_getUncleByBlockHashAndIndex
eth_getHeaderByNumber
eth_getHeaderByHash
eth_sendRawTransaction
net_version
web3_clientVersion
web3_sha3

被拦截的方法列表（methods.deny）

eth_newFilter
eth_newBlockFilter
eth_newPendingTransactionFilter
eth_getFilterLogs
eth_getFilterChanges
eth_uninstallFilter
eth_subscribe
eth_unsubscribe

区块链 Data API

Data API 的开放状态由 GET /v1/chains 返回的 data 字段动态确定：

Blockchain Data API 状态

暂未开放 — Base 主网的 Blockchain Data API 暂未开放。当服务上线后，该区域将自动列出支持的数据集与端点。

开始使用与获取 API Key

新账户注册即得 3,000 万 CU，无需信用卡。

Web 控制台：通过以太坊钱包签名或邮箱注册，并在控制台创建 API key。详细步骤请参阅快速上手指南。
程序化开户：自主 AI Agent、自动化工作流与脚本可通过以太坊钱包签名（EIP-191）免浏览器登录并创建 API key。详见程序化开户指南。
AI Agent：自主 AI Agent 可通过官方 MCP 服务自动发现 Base 支持特性并完成开户与 API key 创建。详见 AI Agent 集成指南。
限额提升：首次付费充值后，解除账户级每秒调用上限；每个 key 仍有默认 CU 速率与突发上限。关于当前费率与计费规则，请参阅定价页面。

下一步

浏览数据集目录，查看 BlockVectra 索引的全部数据集。
查看免费额度与定价，确认账户可用的方案。
登录控制台创建 API key。