# 支援的鏈

> Source: https://docs.blockvectra.com/zh-hant/chains/

BlockVectra 是多鏈區塊鏈資料服務商：在我們支援的每一條鏈上提供 JSON-RPC，並在已開放的鏈上提供 Data API。

## 一個 key，暢通所有鏈

* **通用 key**：同一個 API key 可用於 BlockVectra 支援的所有區塊鏈網路——無需為每條鏈單獨申請 key。
* **URL 中指定鏈**：每個請求透過路徑中的 `{chain}` 參數明確指定目標鏈。
* **統一計量**：帳戶餘額、Compute Unit (CU) 速率限制貯體以及免費方案的每秒請求數上限在所有鏈間共用。
* **計費**：參見[定價](https://blockvectra.com/en/pricing/)。

## 免 API key 體驗

選擇[免費公開 RPC 端點](https://blockvectra.com/en/free/#public-rpc)，無需 API key 即可呼叫錢包常用方法。按網路檢視公開方法與依 IP 限額；呼叫範例見[快速入門](https://docs.blockvectra.com/en/quickstart/)。

## URL 範本

呼叫 JSON-RPC 與 Data API 的標準 URL 結構：

| 服務       | 方式       | URL 範本                       | 說明                                   |
| -------- | -------- | ---------------------------- | ------------------------------------ |
| JSON-RPC | 路徑中帶 key | `POST /v1/{chain}/{api_key}` | 最簡形式；推薦 curl 與 HTTP 用戶端使用            |
| JSON-RPC | 標頭中帶 key | `POST /v1/{chain}`           | 在 `x-api-key: {api_key}` 請求標頭中傳入 key |
| Data API | REST 端點  | `GET /v1/data/{chain}/…`     | 在 `x-api-key` 請求標頭中傳入 key            |
| 狀態       | 公開狀態     | `GET /v1/status`             | 無需 key；傳回各公開鏈的狀態與最新區塊                |

> **注意**：不帶鏈段的請求（如 `POST /v1` 或 `POST /v1/`）傳回 HTTP 404 且回應主體為空。設定詳情見[快速入門](https://docs.blockvectra.com/en/quickstart/)。

## 支援的鏈矩陣

目前在 BlockVectra 上可用的區塊鏈網路及其服務能力：

逐鏈檢視公開端點、帶 key 方法、訂閱類型、傳送交易能力、狀態視窗與日誌跨度、資料集、相關測試網和指南。未知資訊顯示為未知；展開矩陣下方的鏈可檢視該鏈支援的請求範例。

| 鏈 | {chain} | Chain ID | Tracing | 公開端點 | WebSocket | Data API | 帶 key 方法數 | Webhook 推送 | 傳送交易 | 傳送交易（免 key 公開端點） | 歷史狀態保留範圍 | eth_getLogs 單次最大區塊跨度 | Data API 資料集 | 相關測試網 | 相關教學 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| [arb_mainnet RPC 與 Data API](https://blockvectra.com/zh-hant/chains/arb_mainnet/) | arb_mainnet | 42161 | ✓ | `https://api.blockvectra.com/v1/arb_mainnet/public` | 不支援 | 已開放 | 43 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 最近 6,000 個區塊的歷史狀態 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度 | 未知 | 未知 |
| [base_mainnet RPC 與 Data API](https://blockvectra.com/zh-hant/chains/base_mainnet/) | base_mainnet | 8453 | — | `https://api.blockvectra.com/v1/base_mainnet/public` | 不支援 | 已開放 | 39 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 最近 10,000 個區塊的歷史狀態 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度 | 未知 | [Base](https://docs.blockvectra.com/zh/guides/base/) |
| [bsc_mainnet RPC 與 Data API](https://blockvectra.com/zh-hant/chains/bsc_mainnet/) | bsc_mainnet | 56 | — | `https://api.blockvectra.com/v1/bsc_mainnet/public` | 不支援 | 已開放 | 25 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 最近 100 個區塊的歷史狀態 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度 | 未知 | 未知 |
| [以太坊 RPC 與 Data API](https://blockvectra.com/zh-hant/chains/eth_mainnet/) | eth_mainnet | 1 | ✓ | `https://api.blockvectra.com/v1/eth_mainnet/public` | 不支援 | 已開放 | 38 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 最近 250,000 個區塊的歷史狀態 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度 | 未知 | 未知 |
| [eth_sepolia RPC 與 Data API](https://blockvectra.com/zh-hant/chains/eth_sepolia/) | eth_sepolia | 11155111 | — | `https://api.blockvectra.com/v1/eth_sepolia/public` | 不支援 | 已開放 | 29 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 未知 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度 | 未知 | 未知 |
| [HyperEVM RPC 與 Data API](https://blockvectra.com/zh-hant/chains/hyperevm_mainnet/) | hyperevm_mainnet | 999 | — | `https://api.blockvectra.com/v1/hyperevm_mainnet/public` | 不支援 | 已開放 | 24 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 不支援 | 不支援 | 未知 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、餘額、持有者、NFT、資料新鮮度 | 未知 | [HyperEVM 回填与轮询](https://docs.blockvectra.com/zh/guides/hyperevm-backfill/) |
| [polygon_mainnet RPC 與 Data API](https://blockvectra.com/zh-hant/chains/polygon_mainnet/) | polygon_mainnet | 137 | ✓ | `https://api.blockvectra.com/v1/polygon_mainnet/public` | 不支援 | 已開放 | 43 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 最近 126 個區塊的歷史狀態 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度 | 未知 | 未知 |
| [Robinhood Chain RPC 與 Data API](https://blockvectra.com/zh-hant/chains/robinhood_mainnet/) | robinhood_mainnet | 4663 | ✓ | `https://api.blockvectra.com/v1/robinhood_mainnet/public` | 支援 (newHeads, logs) | 已開放 | 43 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 最近 900 個區塊的歷史狀態 | 1,000 個區塊 | 區塊、交易、地址交易、轉帳、代幣中繼資料、餘額、持有者、NFT、DEX 成交、DEX 價格、代幣化股票、Trace、資料新鮮度 | 未知 | [Robinhood Chain](https://docs.blockvectra.com/zh/guides/robinhood-chain/), [股票代币乘数与指标](https://docs.blockvectra.com/zh/guides/stock-token-multiplier/), [代币化股票指标](https://docs.blockvectra.com/zh/guides/stocks/) |
| [robinhood_testnet RPC](https://blockvectra.com/zh-hant/chains/robinhood_testnet/) | robinhood_testnet | 46630 | ✓ | `https://api.blockvectra.com/v1/robinhood_testnet/public` | 支援 (newHeads, logs) | 暫未開放 | 43 | [支援 · 確認數 1–1（預設 1）](https://blockvectra.com/zh-hant/webhooks/), [Webhook 推送指南](https://docs.blockvectra.com/zh/guides/webhook-push/) | 支援 | 支援 | 最近 1,023 個區塊的歷史狀態 | 1,000 個區塊 | 不支援 | 未知 | [测试网水龙头](https://docs.blockvectra.com/zh/guides/robinhood-testnet-faucet/), [Robinhood Chain 测试网入门](https://docs.blockvectra.com/zh/guides/robinhood-testnet-starter/) |

## 拿到 key 之後

### arb_mainnet

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/arb_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/arb_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/arb_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### base_mainnet

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/base_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/base_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/base_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### bsc_mainnet

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/bsc_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/bsc_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/bsc_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### 以太坊

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/eth_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/eth_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/eth_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### eth_sepolia

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/eth_sepolia' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/eth_sepolia' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/eth_sepolia/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### HyperEVM

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/hyperevm_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/hyperevm_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/hyperevm_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### polygon_mainnet

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/polygon_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/polygon_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/polygon_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### Robinhood Chain

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/robinhood_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/robinhood_mainnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### Data API

```bash
curl -fsS 'https://api.blockvectra.com/v1/data/robinhood_mainnet/status/freshness' -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

[Data API](https://docs.blockvectra.com/zh/api/data/)

#### WebSocket

```bash
echo '{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}' | websocat --no-close -H="x-api-key: $BLOCKVECTRA_API_KEY" 'wss://api.blockvectra.com/v1/robinhood_mainnet'
```

[WebSocket](https://docs.blockvectra.com/zh/guides/websocket-subscriptions/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

### robinhood_testnet

#### eth_getLogs

```bash
set -eu
MAX_LOGS_BLOCK_RANGE=1000
head=$(curl -fsS 'https://api.blockvectra.com/v1/robinhood_testnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' | python3 -c 'import json,sys; print(int(json.load(sys.stdin)["result"],16))')
from=$((head >= MAX_LOGS_BLOCK_RANGE ? head - MAX_LOGS_BLOCK_RANGE + 1 : 0))
from_hex=$(printf '0x%x' "$from")
to_hex=$(printf '0x%x' "$head")
curl -fsS 'https://api.blockvectra.com/v1/robinhood_testnet' -H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"eth_getLogs\",\"params\":[{\"fromBlock\":\"$from_hex\",\"toBlock\":\"$to_hex\"}]}"
```

[eth_getLogs](https://docs.blockvectra.com/zh/guides/getlogs-block-range/)

#### WebSocket

```bash
echo '{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}' | websocat --no-close -H="x-api-key: $BLOCKVECTRA_API_KEY" 'wss://api.blockvectra.com/v1/robinhood_testnet'
```

[WebSocket](https://docs.blockvectra.com/zh/guides/websocket-subscriptions/)

[建立 Webhook 訂閱](https://blockvectra.com/zh-hant/webhooks/) · [建立 Webhook 訂閱](https://docs.blockvectra.com/zh/guides/webhook-push/) · [用量與 CU](https://console.blockvectra.com/usage/) · [儲值](https://console.blockvectra.com/billing/)

**HyperEVM**
HyperEVM 的區塊包含 HyperCore 系統交易（傳送方地址為 0x2222…2222 或 0x20…，gasPrice 為 0）。
該鏈暫不支援傳送交易（`eth_sendRawTransaction` 傳回 `-32601` `method_not_allowed`），讀取方法正常。

[檢視即時狀態 →](https://blockvectra.com/zh-hant/status/)

## 以太坊

* **Chain ID**：`1`
* **鏈名（URL 中的 `{chain}`）**：`eth_mainnet`，例如 `POST /v1/eth_mainnet/{api_key}`、`GET /v1/data/eth_mainnet/…`。

### JSON-RPC

* **可用方法**：每條鏈可用的方法以 `GET /v1/chains` 的 `methods.allow` / `deny` 為準（參見[方法策略](https://docs.blockvectra.com/en/api/json-rpc/#method-policy)），不在範圍內的方法傳回 `-32601`。
* **只保留近期資料**：歷史狀態視窗以 `GET /v1/chains` 的 `state_window_blocks`（區塊數）為準。超出視窗的歷史狀態查詢傳回 `-32011`（不計費）；超出視窗的區塊、收據與日誌查詢傳回 `-32000 old data not available due to pruning`（不計費）；依 hash 查詢視窗外的交易傳回 `result: null`。
* **`eth_getLogs`**：單次請求的最大區塊跨度以 `GET /v1/chains` 的 `max_logs_block_range` 為準。

### Data API

* **只保留近期資料**：以太坊資料涵蓋範圍以 `GET /v1/data/chains` 的 `coverage.from_block` 為準。低於起點的區塊號或視窗傳回 `422 no_coverage`；已移出視窗的交易雜湊傳回 `404`。
* **`from_block` 為 `null` 時**：起點暫時未知。不要把它當作 `0` 或完整歷史，在它恢復為整數之前不要對以太坊傳送歷史請求（依區塊號、視窗或雜湊），此類請求會傳回 `503 unavailable`。
* **`503 gateway_overloaded`**：請退避後重試（`Retry-After: 1`）。
* **資料集**：以太坊提供的資料集清單見 `GET /v1/data/chains` 的 `features`；其餘傳回 `422 no_coverage`（不計費）。地址交易與轉帳僅涵蓋視窗範圍：跨越起點的回應會標記為 `meta.coverage: "partial"`。

## 透過程式取得鏈資訊

使用以下公開端點查詢支援的鏈及其狀態：

### 1. 服務狀態 (`GET /v1/status`)

無需 API key 的公開端點（CORS `*`）。僅列出公開可用的鏈，並傳回其狀態和索引頂部區塊：

```bash
curl -s "https://api.blockvectra.com/v1/status"
```

回應範例：

```json
{
  "checked_at": "2026-09-28T07:40:00Z",
  "gateway": { "status": "ok" },
  "chains": [
    {
      "chain": "robinhood_mainnet",
      "name": "Robinhood Chain",
      "chain_id": 4663,
      "jsonrpc": true,
      "data": true,
      "status": "ok",
      "data_status": "ok",
      "sync": { "stage": "synced", "node_block": 74600000, "target_block": null },
      "head": {
        "block": 74600000,
        "time": "2026-09-28T07:39:58Z",
        "lag_seconds": 3
      }
    },
    {
      "chain": "eth_mainnet",
      "name": "Ethereum",
      "chain_id": 1,
      "jsonrpc": true,
      "data": true,
      "status": "ok",
      "data_status": "ok",
      "sync": { "stage": "synced", "node_block": 26010000, "target_block": null },
      "head": {
        "block": 26010000,
        "time": "2026-09-28T07:39:59Z",
        "lag_seconds": 1
      }
    }
  ]
}
```

每個項目的 `name` 始終為鏈的英文顯示名稱。`jsonrpc` 與 `data` 分別回報該鏈是否開放 JSON-RPC 與 Data API；`status` 為 `"ok"` 或 `"unavailable"`。如果鏈正在同步，呼叫該鏈會傳回 `-32010`。在 `/v1/status` 上，`status` 回報 JSON-RPC 是否正常，`data_status` 回報 Data API 是否正常（`"ok"`、`"syncing"` 或 `"unavailable"`）；在 `/v1/data/chains` 中，`coverage.has_data` 為 `false` 表示該鏈尚無已索引的資料。

### 2. Data API 鏈清單 (`GET /v1/data/chains`)

需在 `x-api-key` 請求標頭中帶入 API key（計費）。傳回 Data API 服務的公開鏈，包含所支援的功能（`features`）、資料涵蓋區塊範圍（`coverage`）、節點共識的 `safe`/`finalized` 標記及其狀態（`finality`），以及單次請求限額（`limits`）：

```bash
curl -s "https://api.blockvectra.com/v1/data/chains" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"
```

回應範例：

```json
{
  "data": [
    {
      "chain": "robinhood_mainnet",
      "chain_slug": "ROBINHOOD_MAINNET",
      "name": "Robinhood Chain",
      "chain_id": 4663,
      "chain_external_id": "eip155:4663",
      "features": [
        "blocks", "transactions", "address_transactions", "transfers", "token_metadata",
        "balances", "holders", "nfts", "dex_swaps", "dex_prices", "stocks", "traces", "freshness"
      ],
      "coverage": { "from_block": 0, "traces_from_block": 1000000, "has_data": true },
      "finality": { "model": "node_tags", "status": "ok", "safe_block": 74599400, "finalized_block": 74598900 },
      "limits": { "max_page_size": 500, "max_window_blocks": 100000, "max_pools_for_token": 200, "max_batch_addresses": 100 }
    },
    {
      "chain": "eth_mainnet",
      "chain_slug": "ETH_MAINNET",
      "name": "Ethereum",
      "chain_id": 1,
      "chain_external_id": "eip155:1",
      "features": ["blocks", "transactions", "address_transactions", "transfers", "token_metadata", "freshness"],
      "coverage": { "from_block": 1000000, "traces_from_block": null, "has_data": true },
      "finality": { "model": "node_tags", "status": "stale", "safe_block": 26009950, "finalized_block": 26009900 },
      "limits": { "max_page_size": 500, "max_window_blocks": 100000, "max_pools_for_token": 200, "max_batch_addresses": 100 }
    }
  ]
}
```

`finality` 回報節點共識標記（`model` 為 `"node_tags"`）、標記健康狀況（`status` 為 `"ok"`、`"stale"` 或 `"unavailable"`），以及目前的 `safe_block` 和 `finalized_block`（`safe_block >= finalized_block`，兩者僅在狀態為 `"unavailable"` 時為 `null`）。

`coverage.from_block` 為即時讀取的最低已索引區塊。當鏈的歷史追溯至創世區塊時為 `0`。僅在鏈完全沒有已索引區塊（`has_data = false`）或起點暫時無法確定時才為 `null`：將 `null` 視為未知——而非完整歷史，也不是 `0`——此時歷史請求會傳回 `503 unavailable`。在執行時期請始終從此端點動態讀取，切勿寫死。`coverage.traces_from_block` 為第一個包含 trace 資料的區塊；在此之前的 trace 請求或處於區塊間隙中的請求會傳回 `422 no_coverage`（不計費）。

使用未知或未公開的鏈呼叫 `/v1/data/{chain}/…` 會傳回 HTTP `404` 與 `error.code` `not_found`（不計費；鏈名必須完全為小寫 slug）。