Polygon

Overview

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

Streaming API

Subscribe to real-time blockchain events with sub-second latency using GraphQL over WebSockets. Track token transfers, DEX activity, wallet movements, and OHLCV candlestick data across fast chains like Base and Solana.

Use cases: Trading bots & dashboards, gaming, and AI Agents.

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

Testnets

Polygon Mumbai Testnet

Property	Value
Chain Name	matic-mumbai
Chain ID	80001
Purpose	Development and testing network
Support Level	foundational
Block Explorer	Explorer
Native Gas Token	gwei

Polygon Amoy 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)

• matic-mumbai (testnet)

• polygon-amoy-testnet (testnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/matic-mainnet/address/demo.eth/balances_v2/?key=API_KEY"

SDK Usage

TypeScript SDK (Mainnet)

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

const client = new GoldRushClient("API_KEY");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "matic-mainnet",
    walletAddress: "demo.eth"
});

Foundational API Support

This chain supports 56 GoldRush Foundational APIs:

Wallet API

• Get token balances for address
• Get historical token balances for address
• Get ERC20 token transfers for address
• Get token holders as of any block height (v2)

NFT API

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

Pricing API

• Get pool spot prices
• Get historical token prices

Security API

• Get token approvals for address

Activity Feed API

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

Block Explorer API

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

Streaming API Support

This chain supports the following GoldRush Streaming APIs:

• Token Balances Stream
• Wallet Activity Stream
• New DEX Pairs Stream
• OHLCV Tokens Stream
• OHLCV Pairs Stream

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference