跳至主要內容

Polygon 免費 RPC 節點與 Chain ID

Polygon 的 Chain ID 為 137;免 key 公開端點是 https://api.blockvectra.com/v1/polygon_mainnet/public(每 IP 每秒 3 次請求),eth_getLogs 需要 API key。

開發者與 AI Agent 可透過 HTTP API 連接錢包、建立應用程式。

RPC 端點與網路參數

主網

https://api.blockvectra.com/v1/polygon_mainnet/public

免 API key 試用 RPC

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

新增錢包網路

將這些參數複製到錢包的自訂網路表單。

{
  "networkName": "Polygon",
  "rpcUrl": "https://api.blockvectra.com/v1/polygon_mainnet/public",
  "chainId": 137,
  "currencySymbol": "POL",
  "blockExplorerUrl": "https://polygonscan.com"
}
polygonscan.com

到帳 Webhook 推送

透過 HTTPS 端點接收地址活動。依指南建立訂閱、驗證簽章並對推送去重。

Polygon

到帳 Webhook 推送

接入教學

端點

無需 API key,僅開放錢包常用方法,按 IP 限速。 目前的方法與限額以 GET /v1/chains 為準。

免費公共 RPC 端點
https://api.blockvectra.com/v1/polygon_mainnet/public
curl -X POST 'https://api.blockvectra.com/v1/polygon_mainnet/public' -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
限額:每 IP 每秒 3 次、突發 20、批次 10
發送交易限額:每 IP 每秒 1 次、突發 3
公共方法
  • eth_chainId
  • net_version
  • eth_blockNumber
  • eth_getBalance
  • eth_getTransactionCount
  • eth_getCode
  • eth_getStorageAt
  • eth_call
  • eth_estimateGas
  • eth_gasPrice
  • eth_maxPriorityFeePerGas
  • eth_feeHistory
  • eth_getBlockByNumber
  • eth_getBlockByHash
  • eth_getTransactionByHash
  • eth_getTransactionReceipt
  • eth_syncing
  • web3_clientVersion
  • eth_sendRawTransaction
全部免費公共 RPC 端點
公共歷史視窗:最近 126 個區塊。免費註冊後可用免費 API 額度呼叫本鏈開放的方法。
JSON-RPC(路徑 Key)
https://api.blockvectra.com/v1/polygon_mainnet/{api_key}
JSON-RPC(請求標頭:x-api-key)
https://api.blockvectra.com/v1/polygon_mainnet
x-api-key: {api_key}
Data API
https://api.blockvectra.com/v1/data/polygon_mainnet
x-api-key: {api_key}

WebSocket

WebSocket(路徑 Key)
wss://api.blockvectra.com/v1/polygon_mainnet/{api_key}
WebSocket(請求標頭:x-api-key 或 Authorization)
wss://api.blockvectra.com/v1/polygon_mainnet
x-api-key: {api_key}
Authorization: Bearer {api_key}
支援的訂閱類型
  • newHeads
  • logs (篩選條件必須包含 address 或 topic0)

網路參數

Chain ID137
免費公共 RPC 端點https://api.blockvectra.com/v1/polygon_mainnet/public
帶 key 方法數43
Data API支援
WebSocket 支援支援
Webhook 推送支援 · 確認數 1–200(預設 200)
Webhook 推送指南
傳送交易支援
傳送交易(免 key 公開端點)支援
歷史狀態保留範圍最近 126 個區塊的歷史狀態
eth_getLogs 單次最大區塊跨度1,000 個區塊
Data API 資料集區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度
支援的訂閱類型newHeads、logs
相關測試網未知
相關教學未知

快速範例

curl -X POST https://api.blockvectra.com/v1/polygon_mainnet \
  -H "Content-Type: application/json" \
  -H "x-api-key: {api_key}" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

限制

歷史狀態保留範圍最近 126 個區塊的歷史狀態
eth_getLogs 單次最大區塊跨度1,000 個區塊
方法策略
允許:debug_traceBlockByHash, debug_traceBlockByNumber, debug_traceCall, debug_traceTransaction, eth_blobBaseFee, eth_blockNumber, eth_call, eth_chainId, eth_createAccessList, eth_estimateGas, eth_feeHistory, eth_gasPrice, eth_getBalance, eth_getBlockByHash, eth_getBlockByNumber, eth_getBlockReceipts, eth_getBlockTransactionCountByHash, eth_getBlockTransactionCountByNumber, eth_getCode, eth_getHeaderByHash, eth_getHeaderByNumber, eth_getLogs, eth_getProof, eth_getRawTransactionByBlockHashAndIndex, eth_getRawTransactionByBlockNumberAndIndex, eth_getRawTransactionByHash, eth_getStorageAt, eth_getTransactionByBlockHashAndIndex, eth_getTransactionByBlockNumberAndIndex, eth_getTransactionByHash, eth_getTransactionCount, eth_getTransactionReceipt, eth_getUncleByBlockHashAndIndex, eth_getUncleByBlockNumberAndIndex, eth_getUncleCountByBlockHash, eth_getUncleCountByBlockNumber, eth_maxPriorityFeePerGas, eth_sendRawTransaction, eth_simulateV1, eth_syncing, net_version, web3_clientVersion, web3_sha3

Data API

查詢該鏈資料新鮮度

curl -s "https://api.blockvectra.com/v1/data/polygon_mainnet/status/freshness" -H "x-api-key: {api_key}"

檢視資料集說明文件 →

檢視 Data API 文件 →

選擇任務

按鏈上任務選擇解決方案

拿到 key 之後

eth_getLogs

set -eu
: "${BLOCKVECTRA_API_KEY:?BLOCKVECTRA_API_KEY is required}"
validate_response='import json,re,sys
response=json.load(sys.stdin)
if not (type(response) is dict and response.get("jsonrpc")=="2.0" and type(response.get("id")) is int and response["id"]==1 and "error" not in response and "result" in response):
    sys.exit("Invalid JSON-RPC response")
result=response["result"]
if sys.argv[1]=="head":
    if not (type(result) is str and re.fullmatch(r"0x(?:0|[1-9a-fA-F][0-9a-fA-F]*)",result)):
        sys.exit("Invalid block quantity")
    print(result)
else:
    if not (type(result) is list and all(type(log) is dict for log in result)):
        sys.exit("Invalid logs result")
    print(json.dumps(response,indent=2))'
head_response=$(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":[]}')
head=$(printf '%s' "$head_response" | python3 -c "$validate_response" head)
logs_response=$(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\":\"$head\",\"toBlock\":\"$head\"}]}")
printf '%s' "$logs_response" | python3 -c "$validate_response" logs
eth_getLogs

Data API

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

WebSocket

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/polygon_mainnet'
WebSocket

常見問題

Polygon 的 RPC 端點與 Chain ID 是什麼?

Polygon 的 Chain ID 為 137;免 key 公開端點是 https://api.blockvectra.com/v1/polygon_mainnet/public(每 IP 每秒 3 次請求),eth_getLogs 需要 API key。

可以免 API key 試用 Polygon RPC 嗎?

可以。無需 key 即可在上方公共端點呼叫 eth_chainId。目前方法與每 IP 限額見 GET /v1/chains。

Polygon RPC 是否支援 WebSocket?

Polygon RPC 支援 WebSocket 連線,支援的訂閱類型包括:newHeads, logs。

Polygon RPC 是否支援 debug 方法?

Polygon RPC 支援 debug 方法,包括:debug_traceBlockByHash, debug_traceBlockByNumber, debug_traceCall, debug_traceTransaction。

可以透過 Polygon RPC 廣播交易嗎?

Polygon: 支援.

Polygon 可以查詢多長的歷史狀態?

Polygon: 最近 126 個區塊的歷史狀態.

Polygon 的 eth_getLogs 區塊範圍上限是多少?

Polygon: 1,000 個區塊,eth_getLogs 需要 API key.

Polygon 支援哪些 Data API 資料集?

Polygon: 區塊、交易、地址交易、轉帳、代幣中繼資料、資料新鮮度.

計價說明

註冊即享 30,000,000 CU 免費額度(每 30 天自動補足,餘額與速率限制跨鏈合計,無需信用卡);按方法公開定價,每百萬次呼叫:eth_blockNumber $0.10、eth_call $1.50、eth_getLogs $3.00。

檢視定價方案 →