# 在 Robinhood Chain 上使用 BlockVectra

> 原文地址: https://docs.blockvectra.com/zh/guides/robinhood-chain/

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：

**eth_chainId（请求头鉴权）**

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

```bash
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":[]}'
```


  **eth_blockNumber（路径鉴权）**

在 URL 路径中携带 API key 查询最新区块高度：

```bash
curl -s "https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","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_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`
- `debug_traceTransaction`
- `debug_traceCall`
- `debug_traceBlockByNumber`
- `debug_traceBlockByHash`

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

- `eth_newFilter`
- `eth_newBlockFilter`
- `eth_newPendingTransactionFilter`
- `eth_getFilterLogs`
- `eth_getFilterChanges`
- `eth_uninstallFilter`
- `eth_subscribe`
- `eth_unsubscribe`

## 代币化股票数据

在 Robinhood Chain 上，BlockVectra Data API 针对代币化股票提供每日链上指标与元数据，包含规范中明确定义的两个端点：

* **每日活跃榜单（`GET /v1/data/robinhood_mainnet/stocks`）**：获取指定 UTC 日期的代币化股票活跃榜单，按链上转账活跃度降序排列。
* **单个代币化股票详情（`GET /v1/data/robinhood_mainnet/stocks/{token}`）**：根据代币合约地址查询元数据与最近最多 30 天的每日链上指标。

如需查看完整的请求参数、响应外层结构（`StockDailyListEnvelope` 与 `StockTokenEnvelope`）、分页特性以及 CU 用量估算，请参阅[代币化股票指标指南](https://docs.blockvectra.com/zh/guides/stocks/)。

## 开始使用与获取 API Key

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

* **Web 控制台**：通过以太坊钱包签名或邮箱注册，并在[控制台](https://console.blockvectra.com/zh/login/?next=%2Fzh%2Fkeys%2F)创建 API key。详细步骤请参阅[快速上手指南](https://docs.blockvectra.com/zh/quickstart/)。
* **程序化开户**：自主 AI Agent、自动化工作流与脚本可通过以太坊钱包签名（EIP-191）免浏览器登录并创建 API key。详见[程序化开户指南](https://docs.blockvectra.com/zh/guides/programmatic-signup/)。
* **AI Agent**：自主 AI Agent 可通过官方 MCP 服务自动发现 Robinhood Chain 支持特性并完成开户与 API key 创建。详见 [AI Agent 集成指南](https://docs.blockvectra.com/zh/guides/ai-agents/)。
* **限额提升**：首次付费充值后，解除账户级每秒调用上限；每个 key 仍有默认 CU 速率与突发上限。关于当前费率与计费规则，请参阅[定价页面](https://blockvectra.com/zh/pricing/)。

## 下一步

* [浏览数据集目录](https://blockvectra.com/zh/data/)，查看 BlockVectra 索引的全部数据集。
* [查看免费额度与定价](https://blockvectra.com/zh/pricing/#free)，确认账户可用的方案。
* [登录控制台](https://console.blockvectra.com/zh/login/?next=%2Fzh%2Fkeys%2F)创建 API key。