Polygon (MATIC)

Polygon Network API Reference for efficient interaction with MATIC nodes, enabling fast and low-cost transactions with enhanced scalability on Ethereum-compatible blockchains.

Polygon Network API Reference for efficient interaction with Polygon PoS nodes, enabling fast and low-cost transactions with enhanced scalability on Ethereum-compatible blockchains.

Polygon (formerly Matic Network) is a Layer 2 scaling solution for Ethereum that provides faster and cheaper transactions while maintaining security through its Proof-of-Stake consensus mechanism. The network is fully EVM-compatible, meaning developers can use the same Ethereum tools, libraries, and JSON-RPC methods to interact with Polygon.

This API reference provides comprehensive documentation for all available JSON-RPC methods supported by GetBlock's Polygon infrastructure. These methods enable developers to query blockchain data, submit transactions, interact with smart contracts, and build decentralized applications.

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC API SPECIFICATION.

GetBlock's RPC API reference documentation is provided exclusively for informational purposes and to optimize the developer experience. The canonical and normative specification for Ethereum Virtual Machine (EVM) JSON-RPC methods is solely maintained and published through the official Ethereum Foundation documentation portal at ethereum.org. This resource constitutes the sole authoritative reference implementation of the JSON-RPC 2.0 protocol interface across EVM-compatible execution clients.

Network Information

Property

Value

Network Name

Polygon

Chain ID

137

Native Currency

MATIC

Decimals

Block Time

~2 seconds

Consensus

Proof of Staked(PoS)

EVM Compatible

Yes

Base URL

https://go.getblock.io/<ACCESS-TOKEN>/

Supported Networks

Network

Chain ID

JSON-RPC

WSS

Frankfurt, Germany

New York, USA

Singapore, Singapore

Mainnet

137

✅

Amoy

80002

✅

❌

Quickstart

Setup project

Create and initialize a new project:

mkdir polygon-api-quickstart
cd polygon-api-quickstart
npm init --yes

Install Axios

npm install axios

Create file

Create a new file named index.js. This is where you will make your first call.

Set ES module type

Set the ES module "type": "module" in your package.json.

Add code

Add the following code to index.js:

index.js

const axios = require('axios');

const url = 'https://go.getblock.io/<ACCESS-TOKEN>/';

const payload = {
  jsonrpc: '2.0',
  method: 'eth_blockNumber',
  params: [],
  id: 'getblock.io'
};

axios.post(url, payload, {
  headers: { 'Content-Type': 'application/json' }
})
.then(response => {
  const blockNumber = parseInt(response.data.result, 16);
  console.log('Current Block Number:', blockNumber);
})
.catch(error => console.error(error));

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

Run the script

node index.js

Expected output (example):

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "0x4a87a53"
}

Set up the project directory

mkdir polygon-api-quickstart
cd polygon-api-quickstart

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate

Install requests

pip install requests

Create script

Create a file called main.py with the following content:

main.py

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

Run the script

python main.py

API Method Categories

Account Methods

Methods for retrieving account-related information:

eth_accounts - Returns accounts managed by the node
eth_getBalance - Returns account balance
eth_getTransactionCount - Returns transaction count (nonce)
eth_getCode - Returns contract bytecode
eth_getStorageAt - Returns storage value at position
eth_getProof - Returns Merkle proof for account state

Block Methods

Methods for retrieving block information:

eth_blockNumber - Returns latest block number
eth_getBlockByHash - Returns block by hash
eth_getBlockByNumber - Returns block by number
eth_getBlockTransactionCountByHash - Returns transaction count in block by hash
eth_getBlockTransactionCountByNumber - Returns transaction count in block by number

Transaction Methods

Methods for transaction operations:

eth_getTransactionByHash - Returns transaction by hash
eth_getTransactionByBlockHashAndIndex - Returns transaction by block hash and index
eth_getTransactionByBlockNumberAndIndex - Returns transaction by block number and index
eth_getTransactionReceipt - Returns transaction receipt
eth_sendRawTransaction - Submits signed transaction
eth_sendTransaction - Creates and sends transaction
eth_sign - Signs data with account
eth_pendingTransactions - Returns pending transactions

Smart Contract Methods

Methods for smart contract interaction:

eth_call - Executes contract call without transaction
eth_estimateGas - Estimates gas for transaction

Filter Methods

Methods for event filtering and subscription:

eth_newFilter - Creates log filter
eth_newBlockFilter - Creates block filter
eth_newPendingTransactionFilter - Creates pending transaction filter
eth_getFilterChanges - Returns filter changes
eth_getFilterLogs - Returns filter logs
eth_getLogs - Returns logs matching criteria
eth_uninstallFilter - Removes filter
eth_subscribe - Creates subscription (WebSocket)
eth_unsubscribe - Removes subscription (WebSocket)

Gas Methods

Methods for gas price information:

eth_gasPrice - Returns current gas price
eth_feeHistory - Returns historical gas fees
eth_maxPriorityFeePerGas - Returns max priority fee suggestion

Network Methods

Methods for network information:

eth_chainId - Returns chain ID
eth_syncing - Returns sync status
eth_protocolVersion - Returns protocol version
net_version - Returns network ID
net_listening - Returns listening status
net_peerCount - Returns peer count

Node Methods

Methods for node information:

eth_coinbase - Returns coinbase address
eth_mining - Returns mining status
eth_hashrate - Returns hashrate
rpc_modules - Returns enabled RPC modules
web3_clientVersion - Returns client version
web3_sha3 - Returns Keccak-256 hash

Uncle Methods

Methods for uncle block information:

eth_getUncleByBlockHashAndIndex - Returns uncle by block hash and index
eth_getUncleByBlockNumberAndIndex - Returns uncle by block number and index
eth_getUncleCountByBlockHash - Returns uncle count by block hash
eth_getUncleCountByBlockNumber - Returns uncle count by block number

Support

For technical support and questions:

Support: [email protected]

hashtagNetwork Information

hashtagBase URL

hashtagSupported Networks

hashtagQuickstart

hashtagSetup project

hashtagInstall Axios

hashtagCreate file

hashtagSet ES module type

hashtagAdd code

hashtagRun the script

hashtagSet up the project directory

hashtagCreate and activate a virtual environment

hashtagInstall requests

hashtagCreate script

hashtagRun the script

hashtagAPI Method Categories

hashtagAccount Methods

hashtagBlock Methods

hashtagTransaction Methods

hashtagSmart Contract Methods

hashtagFilter Methods

hashtagGas Methods

hashtagNetwork Methods

hashtagNode Methods

hashtagUncle Methods

hashtagSupport

hashtagSee Also

Network Information

Base URL

Supported Networks

Quickstart

Setup project

Install Axios

Create file

Set ES module type

Add code

Run the script

Set up the project directory

Create and activate a virtual environment

Install requests

Create script

Run the script

API Method Categories

Account Methods

Block Methods

Transaction Methods

Smart Contract Methods

Filter Methods

Gas Methods

Network Methods

Node Methods

Uncle Methods

Support

See Also