Developer resources · Chain 77

Explore the API

Open a method, edit its parameters and try a live request. Public REST and JSON-RPC need no API key.

Try chain stats Try chain ID
REST v2https://api.poa.net/api/v2
JSON-RPC · POSThttps://rpc.poa.net
Health & changeloghttps://poa.net/77/api/v2

USDC · 18 RPC decimals · Chain ID 0x4d · Network details

Requests run only when you click. The playground reads data from the API hosts above; transaction broadcasting is documented separately below. API conventions

GET/statsChain stats, native coin, latest block

Chain stats, native coin, latest block.

Request parameters

No parameters needed.

cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/stats'

GET/healthProducer liveness, PQ NIF, tip age

Producer liveness, PQ NIF, tip age.

Request parameters

No parameters needed.

cURL 
curl --globoff -sS 'https://poa.net/77/api/v2/health'

GET/changelog2d release notes (newest first)

2d release notes (newest first).

Request parameters

No parameters needed.

cURL 
curl --globoff -sS 'https://poa.net/77/api/v2/changelog'

GET/blocksRecent blocks (cursor pagination)

Recent blocks (cursor pagination).

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/blocks'

GET/blocks/{id}One block by height or hash

One block by height or hash.

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/blocks/1'

GET/blocks/{id}/transactionsTransactions in a block

Transactions in a block.

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/blocks/1/transactions'

GET/transactionsRecent transactions (cursor pagination)

Recent transactions (cursor pagination).

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/transactions'

GET/transactions/{hash}One transaction

One transaction.

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/transactions/0x4269ff1d2bb8954d3b6da1b5b2d33be01abab4db6134f4c7fe0e03252b43bd4d'

GET/transactions/{hash}/logsTransaction logs

Transaction logs.

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/transactions/0x4269ff1d2bb8954d3b6da1b5b2d33be01abab4db6134f4c7fe0e03252b43bd4d/logs'

GET/transactions/{hash}/state-changesState changes

State changes.

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/transactions/0x4269ff1d2bb8954d3b6da1b5b2d33be01abab4db6134f4c7fe0e03252b43bd4d/state-changes'

GET/transactions/{hash}/bridgeBridge lock/mint extras

Bridge lock/mint extras.

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/transactions/0x4269ff1d2bb8954d3b6da1b5b2d33be01abab4db6134f4c7fe0e03252b43bd4d/bridge'

GET/addresses/{address}Account overview

Account overview.

Request parameters

Tron example: TCyVw96PSmTA5NcYtkMXVaQdtExiAe8Bq9. Both forms identify the same POA account. Tron Base58Check addresses must have a valid checksum. API responses use the canonical 0x address.

cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/addresses/0x20f68307d06fb9d4a929fd77b16478ed0f96d166'

GET/addresses/{address}/transactionsAccount transactions

Account transactions.

Request parameters

Tron example: TCyVw96PSmTA5NcYtkMXVaQdtExiAe8Bq9. Both forms identify the same POA account. Tron Base58Check addresses must have a valid checksum. API responses use the canonical 0x address.

cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/addresses/0x20f68307d06fb9d4a929fd77b16478ed0f96d166/transactions'

GET/addresses/{address}/bridge-mintsBridge mints to this account

Bridge mints to this account.

Request parameters

Tron example: TCyVw96PSmTA5NcYtkMXVaQdtExiAe8Bq9. Both forms identify the same POA account. Tron Base58Check addresses must have a valid checksum. API responses use the canonical 0x address.

cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/addresses/0x20f68307d06fb9d4a929fd77b16478ed0f96d166/bridge-mints'

GET/bridgesBridge mints (cursor pagination)

Bridge mints (cursor pagination).

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/bridges'

GET/bridges/pendingObserved ETH locks waiting for finality

Observed ETH locks waiting for finality.

Request parameters

No parameters needed.

cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/bridges/pending'

GET/bridges/{eth_event_id}One bridge mint

One bridge mint.

Request parameters
cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/bridges/0x7c60af1660e32b6f34e196bce67c7587745fbe816fd465396856f0b904c5614b'

GET/bridge/intents/{intent_id}Public intent status (no amounts)

Public intent status (no amounts).

Request parameters

This example is a completed transfer (consumed). To track your own transfer, use the intent_id returned when creating its bridge quote. An unknown UUID returns 404.

cURL 
curl --globoff -sS 'https://api.poa.net/api/v2/bridge/intents/f7643fbd-be43-46e6-9c21-2108fc8dc78a'

RPCeth_chainIdChain ID in hexadecimal

Chain ID in hexadecimal.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":[],"method":"eth_chainId","jsonrpc":"2.0"}'

RPCeth_blockNumberLatest block height in hexadecimal

Latest block height in hexadecimal.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":[],"method":"eth_blockNumber","jsonrpc":"2.0"}'

RPCeth_getBalanceNative balance in 18 RPC decimals: [address, block tag]

Native balance in 18 RPC decimals: [address, block tag].

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":["0x0000000000000000000000000000000000000000","latest"],"method":"eth_getBalance","jsonrpc":"2.0"}'

RPCeth_getTransactionByHashTransaction by hash; null if not found

Transaction by hash; null if not found.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":["0x4269ff1d2bb8954d3b6da1b5b2d33be01abab4db6134f4c7fe0e03252b43bd4d"],"method":"eth_getTransactionByHash","jsonrpc":"2.0"}'

RPCeth_getTransactionReceiptReceipt by transaction hash; null if not found

Receipt by transaction hash; null if not found.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":["0x4269ff1d2bb8954d3b6da1b5b2d33be01abab4db6134f4c7fe0e03252b43bd4d"],"method":"eth_getTransactionReceipt","jsonrpc":"2.0"}'

RPCeth_getBlockByNumberBlock: [hex height or latest, include full transactions]

Block: [hex height or latest, include full transactions].

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":["latest",false],"method":"eth_getBlockByNumber","jsonrpc":"2.0"}'

RPCnet_versionChain ID as a decimal string

Chain ID as a decimal string.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":[],"method":"net_version","jsonrpc":"2.0"}'

RPCweb3_clientVersionNode client version

Node client version.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":[],"method":"web3_clientVersion","jsonrpc":"2.0"}'

RPCeth_getTransactionCountAccount nonce: [address, block tag]

Account nonce: [address, block tag].

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":["0x0000000000000000000000000000000000000000","latest"],"method":"eth_getTransactionCount","jsonrpc":"2.0"}'

RPCeth_gasPriceGas price in hexadecimal

Gas price in hexadecimal.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":[],"method":"eth_gasPrice","jsonrpc":"2.0"}'

RPCeth_estimateGasGas estimate: [transaction object]. Does not submit a transaction

Gas estimate: [transaction object]. Does not submit a transaction.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":[{"to":"0x0000000000000000000000000000000000000000","value":"0x0"}],"method":"eth_estimateGas","jsonrpc":"2.0"}'

RPCeth_maxPriorityFeePerGasSuggested priority fee in hexadecimal

Suggested priority fee in hexadecimal.

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":[],"method":"eth_maxPriorityFeePerGas","jsonrpc":"2.0"}'

RPCeth_feeHistoryFee history: [block count, newest block, reward percentiles]

Fee history: [block count, newest block, reward percentiles].

Request parameters
cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":["0x1","latest",[]],"method":"eth_feeHistory","jsonrpc":"2.0"}'

RPCeth_sendRawTransactionBroadcast a signed transaction. Reference only; use your wallet or application to submit

Broadcast a signed transaction. Reference only; use your wallet or application to submit.

This method submits a signed transaction to the network. Use your wallet or application to broadcast it.

cURL 
curl -sS 'https://rpc.poa.net' \
  -H 'content-type: application/json' \
  --data '{"id":1,"params":["0xSIGNED_TRANSACTION"],"method":"eth_sendRawTransaction","jsonrpc":"2.0"}'

API conventions

REST lists return next_page_params. Click Next page to reuse this cursor, or paste it into the cursor field. Clear the field to return to the first page. Token and NFT routes are not supported. Replace any remaining {parameter} placeholders before using a reference cURL command.

JSON-RPC forwards only the methods listed here. Other methods, including personal_* and eth_call, are rejected. Transaction examples use a confirmed POA chain 77 transaction. Replace its hash to inspect another transaction or network. Address examples use that transaction’s sender. REST address methods accept 0x, Tron Base58Check and Tron hex addresses; Ethereum JSON-RPC methods require 0x addresses. The zero address in RPC examples is an editable placeholder.

Agent Gateway uses Bearer API tokens at https://poa.net/77/agent/v1. Create an API token. For paid requests, see x402: unpaid GET https://poa.net/77/x402/demo returns HTTP 402.