跳至主要內容

面向開發者與 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 keyPOST /auth/siwe/challenge、簽名、登入,再 POST /keys。步驟見程式化開戶指南。
位址有動靜時被通知,而不是輪詢Webhook 位址推送按 Webhook 推送指南建立訂閱,每個訂閱最多 1,000,000 個位址。

免 key 的文件 MCP

文件 MCP 服務不需要 API key,可查文件、鏈、即時狀態、價格與用量估算。

僅文件 MCP

search_docs · read_doc
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
僅文件 MCP →(英文)
一條指令,無需 API key:
claude 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"
    }
  }
}
檢視文件站的 Agent 指南 →
免 key 嘗試公開 RPC 呼叫
列出支援的鏈,選擇其中公開方法允許 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 權重,呼叫前就能估算成本。

開啟 GET /v1/plans →

用 USDC / USDT / USDG 付費 →

免費方案

註冊即享 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。 檢視串接方式 →