面向開發者與 AI Agent 的區塊鏈 RPC 和文件 MCP
開發者與 AI Agent 可免 key 發現文件,透過 HTTP 建立憑證,再經認證呼叫受支援的 RPC 或 Data API。
免 key 公開端點:無需 API key 即可呼叫支援的鏈,位址為 https://api.blockvectra.com/v1/<chain>/public,把 <chain> 換成具體鏈名即可,例如 eth_mainnet。每 IP 限額與支援的鏈列表以 GET /v1/chains 為準。
快速回答
免 key:POST https://api.blockvectra.com/v1/<chain>/public 在 29 條鏈上無需帳戶和 API key 即可呼叫,每 IP 每秒 3 次請求(突發 20,批次最多 10 筆)。
出處:GET /v1/chains錢包開戶只要四次 HTTP 呼叫:請求挑戰、用以太坊錢包簽名(EIP-191)、登入(首次登入自動開戶),再 POST /keys 建立 API key。
出處:程式化開戶指南一條指令接入文件 MCP,無需 key:claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp
出處:AI Agent 指南註冊即送 30,000,000 CU,無需信用卡。免費方案按 30 天一個週期,所有 key 共用每秒 25 次呼叫;eth_call 每次 15 CU(每 1,000,000 次 $1.50)。
出處:GET /v1/plans與人同權:建立與撤銷 key、查餘額、鏈上儲值都是 HTTP 呼叫,不是控制台獨有。MCP 服務不能建立或撤銷 key。
出處:程式化開戶指南
我該用哪個?
| 想要 | 用 | 第一步 |
|---|---|---|
| 馬上讀鏈上資料,不想註冊 | 免 key 公開端點 | 向 https://api.blockvectra.com/v1/<chain>/public POST 一個 eth_chainId 的 JSON-RPC 請求。允許的方法見 GET /v1/chains。 |
| 讓 AI 助理查文件、鏈、狀態與價格,並發起唯讀 RPC 呼叫 | 文件 MCP 服務 | 執行下方 MCP 區塊裡的一行指令。詳見 AI Agent 指南。 |
| 呼叫公開清單之外的方法、Data API,或需要 key 自己的限額 | HTTP 開戶並建立 API key | POST /auth/siwe/challenge、簽名、登入,再 POST /keys。步驟見程式化開戶指南。 |
| 位址有動靜時被通知,而不是輪詢 | Webhook 位址推送 | 按 Webhook 推送指南建立訂閱,每個訂閱最多 1,000,000 個位址。 |
免 key 的文件 MCP
文件 MCP 服務不需要 API key,可查文件、鏈、即時狀態、價格與用量估算。
僅文件 MCP
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docsclaude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp其他用戶端:
在 Cline 中開啟 MCP Servers → Configure → Configure MCP Servers,加入以下免 API key 設定:
{
"mcpServers": {
"blockvectra": {
"type": "streamableHttp",
"url": "https://docs.blockvectra.com/mcp"
}
}
}列出支援的鏈,選擇其中公開方法允許 eth_chainId 的鏈。對該鏈和該方法使用 get_method_info,然後在不帶 API key 的情況下透過 rpc_call 呼叫 eth_chainId。把回傳的鏈 ID 與該鏈公布的 chain_id 按數值比較,回報結果及適用的公開限額。如果 ID 缺失、無效或不同,停止並回報,不要聲稱成功。如需呼叫要求 key 的方法或 Data API,先透過 HTTP 開戶並建立 key,再按 Data API 指南接入。需要增加餘額時,可鏈上儲值。
接入指南
- MCP 服務 工具清單、key 要求與用戶端接入。
- LangChain 給 LangChain Agent 配 RPC 工具或接入 MCP 服務。
- ElizaOS 把 EVM 外掛指向 BlockVectra 端點。
- Coinbase AgentKit 在 AgentKit 中使用 BlockVectra RPC 位址。
- 股票代幣活動 用 Data API 讀取股票代幣的每日轉帳活動。
與人同權
透過 HTTP,Agent 可以建立 key(POST /keys)、撤銷 key(POST /keys/{key_id}/revoke)、查餘額(GET /v1/account)並鏈上儲值,限額與價格和在控制台操作的人相同。
MCP 服務可讀文件、鏈、狀態與價格,發起唯讀 RPC 呼叫(rpc_call),廣播已簽名交易(send_raw_transaction);在用戶端設定 key 後還能查帳戶餘額與儲值位址。它沒有建立或撤銷 key 的工具,這些走 HTTP。
Agent 讀得懂的價格
GET /v1/plans 以 JSON 回傳每個方法的 CU 權重,呼叫前就能估算成本。
免費方案
註冊即享 30,000,000 CU 初始額度。首次計費呼叫後開啟 30 天用量週期,到期自動補足至 30,000,000 CU(不累積)。目前帳戶下全部 key 共享平均每秒 25 次呼叫,允許短時突發;每個 key 仍有預設 100 CU/s 限額(突發 400 CU)。
約 2,000,000 次 eth_call
無需信用卡,GitHub/Google/錢包任選登入即建立帳戶。
機器可讀入口
無需帳戶即可發現的機器可讀檔案與目錄:
複製即跑範例
export BLOCKVECTRA_API_KEY=rgw_your_api_key
curl -X POST https://api.blockvectra.com/v1/robinhood_mainnet \
-H "content-type: application/json" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'還沒有 API key?
如果有以太坊錢包:參考程式化建立帳戶指南透過錢包簽名自主建立帳戶建 key,無需瀏覽器。如果沒有錢包:請使用者登入 https://console.blockvectra.com 建一個 key,並設定為環境變數 BLOCKVECTRA_API_KEY。不要讓使用者將 key 貼進對話。
常見問題
不註冊能直接呼叫區塊鏈 RPC 嗎?
可以。POST https://api.blockvectra.com/v1/<chain>/public 在 29 條鏈上無需帳戶和 API key;各鏈允許的方法與每 IP 限額見 GET /v1/chains。清單之外的方法和 Data API 需要 API key。
MCP 能發交易嗎?
能廣播,不能簽名。MCP 服務不持有私鑰:send_raw_transaction 提交的是你在別處簽好的交易,走免 key 端點(該鏈公開方法含 eth_sendRawTransaction)或使用你的 API key。它沒有建立或撤銷 key 的工具。 在 AI Agent 指南檢視 MCP 工具 →
要不要先付款?
不用。錢包首次登入即送 30,000,000 CU 免費額度,無需信用卡也無需儲值;免 key 端點連帳戶都不用。eth_call 每次 15 CU(每 1,000,000 次 $1.50),全部價格見 GET /v1/plans,不夠時可鏈上儲值。
AI Agent 不開瀏覽器怎麼拿到 API key?
四次 HTTP 呼叫:POST /auth/siwe/challenge,用以太坊錢包對回傳的訊息簽名(EIP-191),POST /auth/siwe/login(首次登入自動開戶),再 POST /keys。key 只回傳一次,存進 BLOCKVECTRA_API_KEY。 按程式化開戶指南操作 →
AI Agent 能直接用 BlockVectra 嗎?
可以。Agent 和人使用同一套公開的 JSON-RPC 與 Data API、同一份文件和同一套價格;文件 MCP 服務與機器可讀檔案無需 key。 檢視串接方式 →