Polygon Onchain Data API

Overview

Polygon PoS is the most battle-tested Ethereum scaling solution with 1.3B+ transactions, 130M wallets, and 2.7M monthly active users. The proven choice for production-grade applications.

GoldRush offers the most comprehensive Polygon Data API suite for developers, analysts, and enterprises. Whether you’re building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, our Polygon Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

Supported APIs

Foundational API

Access structured historical blockchain data across 100+ chains using REST APIs. Get token balances, transaction histories, decoded event logs, NFT assets, token holders and more.

Use cases: Wallets, portfolio trackers, crypto accounting & tax tools, and DeFi dashboards.

JSON-RPC

Low-latency EVM JSON-RPC with global failover and archive depth. Point your existing tooling at the GoldRush endpoint — no code changes required.

Use cases: dApps, wallets, indexers, bots, and trading infrastructure.

Mainnet

Property	Value
Chain Name	`matic-mainnet`
Chain ID	`137`
Network Type	Foundational Chain
Support Level	foundational
Block Explorer	PolygonScan
Official Website	Polygon Website
Native Gas Token	MATIC

Testnet

Property	Value
Chain Name	`polygon-amoy-testnet`
Chain ID	`80002`
Purpose	Development and testing network
Support Level	foundational
Block Explorer	Amoy PolygonScan
Official Website	Polygon Amoy Testnet Website
Native Gas Token	gwei

API Usage

To use this blockchain network in GoldRush API calls, use:

Chain Name

matic-mainnet (mainnet)
polygon-amoy-testnet (testnet)

Example API Calls

curl -X GET "https://api.covalenthq.com/v1/matic-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

curl -X GET "https://api.covalenthq.com/v1/polygon-amoy-testnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

SDK Usage

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "matic-mainnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "polygon-amoy-testnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

Foundational API Support

This chain supports 28 GoldRush Foundational APIs:

Wallet API

NFT API

Pricing API

Internal Transactions (`with-internal`)

Polygon supports internal transactions (traces). The Transactions API endpoints marked with-traces above accept the with-internal=true query parameter, which includes internal transactions (the value transfers triggered by contract execution that are not recorded as standalone onchain transactions) in the response.

Internal transactions are included in the response by passing with-internal and cost 0.05 credits/item.

Example API Call

Recent transactions with internal transactions

curl -X GET "https://api.covalenthq.com/v1/matic-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-internal=true&key=<GOLDRUSH_API_KEY>"

JSON-RPC

Polygon is available on the GoldRush JSON-RPC service. Point your existing EVM tooling (ethers.js, viem, web3.js, or raw HTTP) at the GoldRush endpoint — the standard eth_*, net_*, web3_*, debug_*, and trace_* methods are supported.

Endpoint

https://rpc.goldrushdata.com/v1/matic-mainnet

Example JSON-RPC Calls

curl https://rpc.goldrushdata.com/v1/matic-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

curl https://rpc.goldrushdata.com/v1/matic-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"]}'

Sample Methods

eth_blockNumber on Polygon
eth_getBalance on Polygon
eth_call on Polygon
eth_getLogs on Polygon
eth_getTransactionReceipt on Polygon

See the full method list and per-method examples for Polygon.

Overview

Popular Chains 🔥

Foundational Chains

Frontier Chains

Community Chains

Archived Chains

Overview

Supported APIs

Foundational API

JSON-RPC

Mainnet

Testnet

API Usage

Chain Name

Example API Calls

SDK Usage

Foundational API Support

Wallet API

NFT API

Pricing API

Security API

Transactions API

Block Explorer API

Internal Transactions (`with-internal`)

Example API Call

JSON-RPC

Endpoint

Example JSON-RPC Calls

Sample Methods

Additional Resources

​Overview

​Supported APIs

Foundational API

JSON-RPC

​Mainnet

​Testnet

​API Usage

​Chain Name

​Example API Calls

​SDK Usage

​Foundational API Support

​Wallet API

​NFT API

​Pricing API

​Security API

​Transactions API

​Block Explorer API

​Internal Transactions (with-internal)

​Example API Call

​JSON-RPC

​Endpoint

​Example JSON-RPC Calls

​Sample Methods

​Additional Resources

Overview

Supported APIs

Mainnet

Testnet

API Usage

Chain Name

Example API Calls

SDK Usage

Foundational API Support

Wallet API

NFT API

Pricing API

Security API

Transactions API

Block Explorer API

Internal Transactions (`with-internal`)

Example API Call

JSON-RPC

Endpoint

Example JSON-RPC Calls

Sample Methods

Additional Resources