Polygon RPC - PolyNode

Endpoint

https://rpc.polynode.dev

Standard Ethereum JSON-RPC over HTTPS for Polygon reads and priority transaction submission. Change your HTTP RPC URL and add your API key. WebSocket subscriptions and privileged node methods are intentionally outside this endpoint’s current scope.

Authentication

Every request requires a valid polynode API key. Pass it as a header:

x-api-key: YOUR_API_KEY

Or as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Requests without a valid key receive a -32000 error.

Rate Limit

Active Growth and Enterprise accounts are rate-limited to 50 requests per second per account. Exceeding this returns a -32005 error. Batch requests count as one HTTP request and may contain up to 1,000 JSON-RPC calls. Calls within a batch are processed sequentially.

Transport

The production endpoint is HTTP/HTTPS only. It does not currently accept WebSocket upgrades, so eth_subscribe, eth_unsubscribe, and newHeads are not available at rpc.polynode.dev yet.

Supported Methods

Method	Source	Description
`eth_sendRawTransaction`	Priority routing	P2P delivery to block-producing validator
`eth_chainId`	Local	Returns `0x89` (137)
`eth_blockNumber`	Local cache	Latest cached reference/P2P chain tip
`eth_gasPrice`	Local	Calibrated for optimal block positioning
`net_version`	Local	Returns `137`
`net_peerCount`	Local	Connected P2P peer count
`web3_clientVersion`	Local	Returns `PolyNode/1.0.0`
`eth_call`	Polygon upstream	Contract read calls
`eth_getBalance`	Polygon upstream	Account balance queries
`eth_getTransactionCount`	Polygon upstream	Nonce queries
`eth_estimateGas`	Polygon upstream	Gas estimation
`eth_getBlockByNumber`	Polygon upstream	Block data
`eth_getTransactionReceipt`	Polygon upstream	Transaction receipts
`eth_getLogs`	Polygon upstream	Log queries

Historical availability follows the configured Polygon upstream. Current production can answer historical block and state queries, but PolyNode does not operate an independent archive behind this endpoint and does not guarantee every historical height. Use latest or recent blocks when archival completeness matters.

Common Queries

Check a wallet’s MATIC balance

curl -X POST https://rpc.polynode.dev \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0xYOUR_WALLET_ADDRESS", "latest"],
    "id": 1
  }'

The result is the balance in wei (hex). Divide by 10^18 for MATIC.

Check a wallet’s USDC balance

Use eth_call with the ERC-20 balanceOf(address) function:

curl -X POST https://rpc.polynode.dev \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "data": "0x70a08231000000000000000000000000YOUR_WALLET_ADDRESS_WITHOUT_0x"
    }, "latest"],
    "id": 1
  }'

Replace YOUR_WALLET_ADDRESS_WITHOUT_0x with the 40-character address (no 0x prefix), zero-padded to 64 characters. The result is the balance in the token’s smallest unit (hex). USDC has 6 decimals. Common Polygon token contracts:

Token	Address
USDC	`0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359`
USDC.e (bridged)	`0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174`
USDT	`0xc2132D05D31c914a87C6611C10748AEb04B58e8F`
WMATIC	`0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270`
WETH	`0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619`

Read any contract function

The data field for eth_call is the function selector (first 4 bytes of the keccak256 hash) followed by ABI-encoded arguments. Common selectors:

Function	Selector	Arguments
`balanceOf(address)`	`0x70a08231`	address (32 bytes, left-padded)
`totalSupply()`	`0x18160ddd`	none
`decimals()`	`0x313ce567`	none
`symbol()`	`0x95d89b41`	none
`name()`	`0x06fdde03`	none
`allowance(address,address)`	`0xdd62ed3e`	owner (32 bytes) + spender (32 bytes)

Get the current block number

curl -X POST https://rpc.polynode.dev \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Get a transaction receipt

curl -X POST https://rpc.polynode.dev \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionReceipt",
    "params": ["0xYOUR_TX_HASH"],
    "id": 1
  }'

Batch Requests

Send multiple calls in a single HTTP request:

curl -X POST https://rpc.polynode.dev \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '[
    {"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1},
    {"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":2},
    {"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":3}
  ]'

Batch requests count as a single HTTP request against the rate limit and are capped at 1,000 calls.

Error Codes

Code	Meaning
`-32000`	Missing or invalid API key
`-32005`	Rate limit exceeded (max 50 requests/second)
`-32600`	Invalid request, including an oversized batch
`-32601`	Method not available
`-32602`	Invalid parameters
`-32603`	Upstream error

​Endpoint

​Authentication

​Rate Limit

​Transport

​Supported Methods

​Common Queries

​Check a wallet’s MATIC balance

​Check a wallet’s USDC balance

​Read any contract function

​Get the current block number

​Get a transaction receipt

​Batch Requests

​Error Codes

Endpoint

Authentication

Rate Limit

Transport

Supported Methods

Common Queries

Check a wallet’s MATIC balance

Check a wallet’s USDC balance

Read any contract function

Get the current block number

Get a transaction receipt

Batch Requests

Error Codes