Polygon Onchain Data API

Get token balances and transactions for Polygon. 28 endpoints supported. Testnet supported.

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.

Read docs

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.

Read docs

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

Chain Name (Mainnet)

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

SDK Usage

TypeScript SDK (Mainnet)

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

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

Foundational API Support

This chain supports 28 GoldRush Foundational APIs:

Wallet API

• Get token holders as of any block height (v2) on Polygon
• Get historical token balances for address on Polygon
• Get token balances for address on Polygon
• Get native token balance for address on Polygon
• Get historical portfolio value over time on Polygon
• Get ERC20 token transfers for address on Polygon

NFT API

• Get NFTs for address on Polygon
• Check ownership in NFT collection on Polygon
• Check ownership in NFT collection for specific token on Polygon

Pricing API

• Get pool spot prices on Polygon
• Get historical token prices on Polygon

Security API

• Get token approvals for address on Polygon

Transactions API

• Get a transaction on Polygon with-traces
• Get transaction summary for address on Polygon
• Get earliest transactions for address (v3) on Polygon with-traces
• Get recent transactions for address (v3) on Polygon with-traces
• Get paginated transactions for address (v3) on Polygon with-traces
• Get bulk time bucket transactions for address (v3) on Polygon
• Get all transactions in a block (v3) on Polygon
• Get all transactions in a block by page (v3) on Polygon

Block Explorer API

• Get a block on Polygon
• Get all chain statuses on Polygon
• Get all chains on Polygon
• Get block heights on Polygon
• Get gas prices on Polygon
• Get log events by contract address on Polygon
• Get log events by topic hash(es) on Polygon
• Get logs on Polygon

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

eth_blockNumber

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":[]}'

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.

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference