Base RPC URL：免 key 存取、curl 與 viem 範例

透過公開 RPC URL 或 API key 連線至 Base 主網：在路徑或請求標頭傳入金鑰，呼叫 eth_chainId 讀取鏈並查詢最新區塊高度，頁面提供請求範例、每 IP 限額與回應欄位，缺少金鑰時傳回錯誤碼。

先使用下方 Base 主網公開 RPC URL，無需 API key 即可讀取 chain ID。支援的方法與每 IP 限制請見 Base 鏈頁面；若需要 public.methods 之外、該鏈允許的方法，請使用 key。

curl -sS "https://api.blockvectra.com/v1/base_mainnet/public" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

網路資訊與端點

每個送往 Base 的請求都會在 URL 路徑中以識別代號 base_mainnet 明確指定目標網路。JSON-RPC 同時支援路徑式 key 驗證與請求標頭驗證（x-api-key）。

參數 / 端點	取值 / 範本	驗證方式
Chain ID（EIP-155）	`8453`	—
JSON-RPC（路徑攜帶 Key）	`POST https://api.blockvectra.com/v1/base_mainnet/{api_key}`	URL 路徑中傳入 API key
JSON-RPC（請求標頭攜帶 Key）	`POST https://api.blockvectra.com/v1/base_mainnet`	傳入 x-api-key: {api_key} 請求標頭
Data API 基址	`GET https://api.blockvectra.com/v1/data/base_mainnet/…`	傳入 x-api-key: {api_key} 請求標頭
公開狀態端點	`GET https://api.blockvectra.com/v1/status`	無需驗證（公開）

直接 curl 與 viem 範例

你可以直接使用 curl 或 viem 等 web3 用戶端程式庫發起 JSON-RPC 呼叫。請在環境變數 BLOCKVECTRA_API_KEY 中設定你的 API key：

使用 x-api-key 請求標頭查詢 EIP-155 chain ID：

curl -s "https://api.blockvectra.com/v1/base_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'

回應結構

回應遵循 JSON-RPC 2.0 規範：

成功：傳回包含 jsonrpc: "2.0"、相符的整數 id 及十六進位編碼 result 的物件（eth_chainId 傳回十六進位編碼的 chain ID；eth_blockNumber 傳回最新區塊高度）。
不允許的方法：請求該網路允許方法之外的方法，會傳回 JSON-RPC 錯誤碼 -32601（method not available，不計費）。
超出視窗的查詢：早於狀態保留視窗的歷史狀態請求會傳回 JSON-RPC 錯誤碼 -32011（不計費）。
缺少 API key：省略 key 會傳回 HTTP 401 與 JSON-RPC 錯誤碼 -32024（missing_api_key，不計費）。
無效參數：格式錯誤的請求參數會傳回 JSON-RPC 錯誤碼 -32602（不計費）。

能力與方法策略

即時數值：GET /v1/chains（methods、max_logs_block_range、state_window_blocks）。

網路參數與呼叫限制

eth_getLogs 單次區塊跨度: 單次最多 1000 個區塊
歷史狀態視窗: 最近 10000 個區塊（超出視窗回傳 -32011）
執行追蹤（debug_trace*）: 暫不支援

各鏈允許的方法見支援的鏈

區塊鏈 Data API

即時數值：GET /v1/chains（data）。

Blockchain Data API 狀態

已開放 — Base 主網的 Blockchain Data API 現已開放。支援的資料集與介面請參閱資料集目錄。瀏覽資料集目錄 →

開始使用與 API key

新帳戶註冊即得 30,000,000 CU，無需信用卡。

Web 控制台：透過以太坊錢包簽名註冊，並在控制台產生 API key。設定詳情請參閱快速入門指南。
程式化註冊：自主 AI Agent、自動化指令碼與 CI 管線可使用以太坊錢包簽名（EIP-191）在無瀏覽器的情況下登入並佈建 API key。請參閱程式化註冊指南。
AI Agent：自主 AI Agent 可使用官方 Model Context Protocol (MCP) 伺服器探索 Base 能力。請參閱將 AI Agent 連線至 BlockVectra。
升級限制：儲值後，帳戶整體的每秒呼叫次數限制將被移除；每個 key 仍受計算單位（CU）速率與突發限制約束。有關目前的費率與計費單位，請參閱定價頁面。

下一步

瀏覽資料集目錄，查看 BlockVectra 索引的全部資料集。
查看免費方案與定價，確認你的帳戶包含的內容。
登入控制台建立 API key。