在 Robinhood Chain 上使用 BlockVectra
通过 BlockVectra 接入 Robinhood Chain 主网的 JSON-RPC 与 Data API:链 ID、端点、curl 示例、方法策略与代币化股票数据。
BlockVectra 提供 Robinhood Chain 主网的 JSON-RPC 与 Data API 访问,通过统一的 API 端点为开发者提供服务。
链信息与端点
针对 Robinhood Chain 的每次请求均通过 URL 路径中的 robinhood_mainnet 标识目标链。JSON-RPC 同时支持在 URL 路径中携带 Key 以及在请求头中传入 x-api-key 两种鉴权写法;Data API 则在 /v1/data/robinhood_mainnet/ 下提供 REST 查询端点。
以下参数与端点来自当前网络数据:
| 参数 / 端点 | 取值 / 模板 | 鉴权方式 |
|---|---|---|
| Chain ID(EIP-155) | 4663 | 无需鉴权(公开) |
| JSON-RPC(路径携带 Key) | POST https://api.blockvectra.com/v1/robinhood_mainnet/{api_key} | URL 路径中传入 API key |
| JSON-RPC(请求头携带 Key) | POST https://api.blockvectra.com/v1/robinhood_mainnet | 传入 x-api-key: {api_key} 请求头 |
| Data API 基址 | GET https://api.blockvectra.com/v1/data/robinhood_mainnet/… | 传入 x-api-key: {api_key} 请求头 |
| 公开状态端点 | GET https://api.blockvectra.com/v1/status | 无需鉴权(公开) |
直接运行的 curl 示例
可以使用标准 HTTP 客户端直接发起 JSON-RPC 调用。请将 {api_key} 替换为你的 BlockVectra API key:
通过 x-api-key 请求头查询 EIP-155 链 ID:
curl -s "https://api.blockvectra.com/v1/robinhood_mainnet" \
-H "Content-Type: application/json" \
-H "x-api-key: {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(不计费)。 - 参数错误:请求参数格式不符合要求返回 JSON-RPC 错误码
-32602(不计费)。
支持情况与方法策略
Robinhood Chain 上可用的 JSON-RPC 方法、日志区块跨度上限以及历史状态保留窗口通过 GET /v1/chains 动态发布。执行追踪(debug_trace* 系列,包括 debug_traceTransaction)是否开放同样由该链的方法策略决定:
网络参数与调用限制
- eth_getLogs 单次区块跨度: 单次最多 1000 个区块
- 历史状态窗口: 最近 900 个区块(超出窗口返回 -32011)
- 执行追踪(debug_trace*): 已支持(含 debug_traceTransaction、debug_traceCall、debug_traceBlockByNumber、debug_traceBlockByHash)
允许的方法列表(methods.allow)
eth_blockNumbereth_chainIdeth_gasPriceeth_maxPriorityFeePerGaseth_blobBaseFeeeth_feeHistoryeth_syncingeth_getBalanceeth_getCodeeth_getStorageAteth_getTransactionCounteth_calleth_estimateGaseth_createAccessListeth_getProofeth_simulateV1eth_getBlockByNumbereth_getBlockByHasheth_getBlockReceiptseth_getBlockTransactionCountByNumbereth_getBlockTransactionCountByHasheth_getTransactionByHasheth_getTransactionReceipteth_getTransactionByBlockNumberAndIndexeth_getTransactionByBlockHashAndIndexeth_getRawTransactionByHasheth_getRawTransactionByBlockHashAndIndexeth_getRawTransactionByBlockNumberAndIndexeth_getLogseth_getUncleCountByBlockNumbereth_getUncleCountByBlockHasheth_getUncleByBlockNumberAndIndexeth_getUncleByBlockHashAndIndexeth_getHeaderByNumbereth_getHeaderByHasheth_sendRawTransactionnet_versionweb3_clientVersionweb3_sha3debug_traceTransactiondebug_traceCalldebug_traceBlockByNumberdebug_traceBlockByHash
被拦截的方法列表(methods.deny)
eth_newFiltereth_newBlockFiltereth_newPendingTransactionFiltereth_getFilterLogseth_getFilterChangeseth_uninstallFiltereth_subscribeeth_unsubscribe
代币化股票数据
在 Robinhood Chain 上,BlockVectra Data API 针对代币化股票提供每日链上指标与元数据,包含规范中明确定义的两个端点:
- 每日活跃榜单(
GET /v1/data/robinhood_mainnet/stocks):获取指定 UTC 日期的代币化股票活跃榜单,按链上转账活跃度降序排列。 - 单个代币化股票详情(
GET /v1/data/robinhood_mainnet/stocks/{token}):根据代币合约地址查询元数据与最近最多 30 天的每日链上指标。
如需查看完整的请求参数、响应外层结构(StockDailyListEnvelope 与 StockTokenEnvelope)、分页特性以及 CU 用量估算,请参阅代币化股票指标指南。
开始使用与获取 API Key
新账户注册即得 3,000 万 CU,无需信用卡。- Web 控制台:通过以太坊钱包签名或邮箱注册,并在控制台创建 API key。详细步骤请参阅快速上手指南。
- 程序化开户:自主 AI Agent、自动化工作流与脚本可通过以太坊钱包签名(EIP-191)免浏览器登录并创建 API key。详见程序化开户指南。
- AI Agent:自主 AI Agent 可通过官方 MCP 服务自动发现 Robinhood Chain 支持特性并完成开户与 API key 创建。详见 AI Agent 集成指南。
- 限额提升:首次付费充值后,解除账户级每秒调用上限;每个 key 仍有默认 CU 速率与突发上限。关于当前费率与计费规则,请参阅定价页面。
下一步
最后更新: