# Polygon (MATIC)

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.

{% hint style="info" %}
*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*](http://ethereum.org/)*. This resource constitutes the sole authoritative reference implementation of the JSON-RPC 2.0 protocol interface across EVM-compatible execution clients.*
{% endhint %}

## Network Information

| Property        | Value                |
| --------------- | -------------------- |
| Network Name    | Polygon              |
| Chain ID        | 137                  |
| Native Currency | MATIC                |
| Decimals        | 18                   |
| Block Time      | \~2 seconds          |
| Consensus       | Proof of Staked(PoS) |
| EVM Compatible  | Yes                  |

## Base URL

{% tabs %}
{% tab title="Frankfurt, Germany" %}

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

{% endtab %}

{% tab title="New York, USA" %}

```
https://go.getblock.us/<ACCESS-TOKEN>/
```

{% endtab %}

{% tab title="Singapore, Singapore" %}

```
https://go.getblock.asia/<ACCESS-TOKEN>/
```

{% endtab %}
{% endtabs %}

## Supported Networks

| Network | Chain ID | JSON-RPC | WSS | Frankfurt, Germany | New York, USA | Singapore, Singapore |
| ------- | -------- | -------- | --- | ------------------ | ------------- | -------------------- |
| Mainnet | 137      | ✅        | ✅   | ✅                  | ✅             | ✅                    |
| Amoy    | 80002    | ✅        | ✅   | ✅                  | ❌             | ❌                    |

## Quickstart

{% tabs %}
{% tab title="Javascript(Axios)" %}
{% stepper %}
{% step %}

### Setup project

Create and initialize a new project:

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

{% endstep %}

{% step %}

### Install Axios

```bash
npm install axios
```

{% endstep %}

{% step %}

### Create file

Create a new file named `index.js`. This is where you will make your first call.
{% endstep %}

{% step %}

### Set ES module type

Set the ES module `"type": "module"` in your `package.json`.
{% endstep %}

{% step %}

### Add code

Add the following code to `index.js`:

{% code title="index.js" %}

```javascript
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));
```

{% endcode %}

Replace `<ACCESS-TOKEN>` with your actual access token from GetBlock.
{% endstep %}

{% step %}

### Run the script

```bash
node index.js
```

Expected output (example):

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

{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Python(Request)" %}
{% stepper %}
{% step %}

### Set up the project directory

```bash
mkdir polygon-api-quickstart
cd polygon-api-quickstart
```

{% endstep %}

{% step %}

### Create and activate a virtual environment

```bash
python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate
```

{% endstep %}

{% step %}

### Install requests

```bash
pip install requests
```

{% endstep %}

{% step %}

### Create script

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

{% code title="main.py" %}

```python
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)
```

{% endcode %}

Replace `<ACCESS-TOKEN>` with your actual access token from GetBlock.
{% endstep %}

{% step %}

### Run the script

```bash
python main.py
```

{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

### 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: <support@getblock.io>

## See Also

* [Polygon Documentation](https://docs.polygon.technology/)
* [Polygon PoS Block Explorer](https://polygonscan.com/)
* [Polygon Website](https://polygon.technology/)
* [Ethereum JSON-RPC Specification](https://ethereum.org/developers/docs/apis/json-rpc/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.getblock.io/api-reference/polygon-matic.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.