# Table of Contents - [What is GoldRush - GoldRush API Documentation](#what-is-goldrush-goldrush-api-documentation) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [GoldRush SDKs - GoldRush API Documentation](#goldrush-sdks-goldrush-api-documentation) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Page Not Found](#page-not-found) - [Powered by GoldRush - GoldRush API Documentation](#powered-by-goldrush-goldrush-api-documentation) - [Frequently Asked Questions - GoldRush API Documentation](#frequently-asked-questions-goldrush-api-documentation) - [GoldRush MCP Server - GoldRush API Documentation](#goldrush-mcp-server-goldrush-api-documentation) - [Overview - GoldRush API Documentation](#overview-goldrush-api-documentation) - [Changelog - GoldRush API Documentation](#changelog-goldrush-api-documentation) - [Overview - GoldRush API Documentation](#overview-goldrush-api-documentation) - [Supported Chains - GoldRush API Documentation](#supported-chains-goldrush-api-documentation) - [Quickstart - GoldRush API Documentation](#quickstart-goldrush-api-documentation) - [Authentication - GoldRush API Documentation](#authentication-goldrush-api-documentation) - [Enhanced Bitcoin Support - GoldRush API Documentation](#enhanced-bitcoin-support-goldrush-api-documentation) - [NFT Supported Formats - GoldRush API Documentation](#nft-supported-formats-goldrush-api-documentation) - [Enhanced Spam Lists - GoldRush API Documentation](#enhanced-spam-lists-goldrush-api-documentation) - [ADI Chain - GoldRush API Documentation](#adi-chain-goldrush-api-documentation) - [Arc Testnet - GoldRush API Documentation](#arc-testnet-goldrush-api-documentation) - [Quickstart - GoldRush API Documentation](#quickstart-goldrush-api-documentation) - [Authentication - GoldRush API Documentation](#authentication-goldrush-api-documentation) - [Page Not Found](#page-not-found) - [Get token balances for address - GoldRush API Documentation](#get-token-balances-for-address-goldrush-api-documentation) - [Get token approvals for address - GoldRush API Documentation](#get-token-approvals-for-address-goldrush-api-documentation) - [Get Bitcoin balance for non-HD address - GoldRush API Documentation](#get-bitcoin-balance-for-non-hd-address-goldrush-api-documentation) - [Get transaction summary for address - GoldRush API Documentation](#get-transaction-summary-for-address-goldrush-api-documentation) - [New DEX Pairs Stream - GoldRush API Documentation](#new-dex-pairs-stream-goldrush-api-documentation) - [Get NFTs for address - GoldRush API Documentation](#get-nfts-for-address-goldrush-api-documentation) - [OHLCV Tokens Stream - GoldRush API Documentation](#ohlcv-tokens-stream-goldrush-api-documentation) - [Get top trading wallets for token - GoldRush API Documentation](#get-top-trading-wallets-for-token-goldrush-api-documentation) - [OHLCV Pairs Stream - GoldRush API Documentation](#ohlcv-pairs-stream-goldrush-api-documentation) - [SDK Guide - GoldRush API Documentation](#sdk-guide-goldrush-api-documentation) - [Page Not Found](#page-not-found) - [Update Pairs Stream - GoldRush API Documentation](#update-pairs-stream-goldrush-api-documentation) - [Get logs - GoldRush API Documentation](#get-logs-goldrush-api-documentation) - [Page Not Found](#page-not-found) - [GoldRush Playground - GoldRush API Documentation](#goldrush-playground-goldrush-api-documentation) - [Decoded Events - GoldRush API Documentation](#decoded-events-goldrush-api-documentation) - [Wallet Activity Stream - GoldRush API Documentation](#wallet-activity-stream-goldrush-api-documentation) - [Get PnL for wallet - GoldRush API Documentation](#get-pnl-for-wallet-goldrush-api-documentation) - [GraphQL Endpoints - GoldRush API Documentation](#graphql-endpoints-goldrush-api-documentation) - [Monad - GoldRush API Documentation](#monad-goldrush-api-documentation) - [Plasma - GoldRush API Documentation](#plasma-goldrush-api-documentation) - [Bitcoin - GoldRush API Documentation](#bitcoin-goldrush-api-documentation) - [HyperEVM - GoldRush API Documentation](#hyperevm-goldrush-api-documentation) - [Manta Pacific Testnet - GoldRush API Documentation](#manta-pacific-testnet-goldrush-api-documentation) - [Loot Chain - GoldRush API Documentation](#loot-chain-goldrush-api-documentation) - [HyperCore - GoldRush API Documentation](#hypercore-goldrush-api-documentation) - [Cronos - GoldRush API Documentation](#cronos-goldrush-api-documentation) - [Harmony - GoldRush API Documentation](#harmony-goldrush-api-documentation) - [Sonic - GoldRush API Documentation](#sonic-goldrush-api-documentation) - [Solana - GoldRush API Documentation](#solana-goldrush-api-documentation) - [Lisk - GoldRush API Documentation](#lisk-goldrush-api-documentation) - [Optimism - GoldRush API Documentation](#optimism-goldrush-api-documentation) - [Polygon - GoldRush API Documentation](#polygon-goldrush-api-documentation) - [Ethereum - GoldRush API Documentation](#ethereum-goldrush-api-documentation) - [BNB Smart Chain (BSC) - GoldRush API Documentation](#bnb-smart-chain-bsc-goldrush-api-documentation) - [Avalanche C-Chain - GoldRush API Documentation](#avalanche-c-chain-goldrush-api-documentation) - [Arbitrum - GoldRush API Documentation](#arbitrum-goldrush-api-documentation) - [Axie/Ronin - GoldRush API Documentation](#axie-ronin-goldrush-api-documentation) - [Gnosis - GoldRush API Documentation](#gnosis-goldrush-api-documentation) - [Berachain - GoldRush API Documentation](#berachain-goldrush-api-documentation) - [ApeChain - GoldRush API Documentation](#apechain-goldrush-api-documentation) - [Lens - GoldRush API Documentation](#lens-goldrush-api-documentation) - [Mantle - GoldRush API Documentation](#mantle-goldrush-api-documentation) - [Sei - GoldRush API Documentation](#sei-goldrush-api-documentation) - [Blast - GoldRush API Documentation](#blast-goldrush-api-documentation) - [Taiko - GoldRush API Documentation](#taiko-goldrush-api-documentation) - [Scroll - GoldRush API Documentation](#scroll-goldrush-api-documentation) - [Covalent - GoldRush API Documentation](#covalent-goldrush-api-documentation) - [Ink - GoldRush API Documentation](#ink-goldrush-api-documentation) - [Oasis - GoldRush API Documentation](#oasis-goldrush-api-documentation) - [Oasis Sapphire - GoldRush API Documentation](#oasis-sapphire-goldrush-api-documentation) - [Redstone - GoldRush API Documentation](#redstone-goldrush-api-documentation) - [Fantom - GoldRush API Documentation](#fantom-goldrush-api-documentation) - [Unichain - GoldRush API Documentation](#unichain-goldrush-api-documentation) - [Moonbeam - GoldRush API Documentation](#moonbeam-goldrush-api-documentation) - [Viction - GoldRush API Documentation](#viction-goldrush-api-documentation) - [Canto - GoldRush API Documentation](#canto-goldrush-api-documentation) - [Celo - GoldRush API Documentation](#celo-goldrush-api-documentation) - [Cronos zkEVM - GoldRush API Documentation](#cronos-zkevm-goldrush-api-documentation) - [Moonriver - GoldRush API Documentation](#moonriver-goldrush-api-documentation) - [World Chain - GoldRush API Documentation](#world-chain-goldrush-api-documentation) - [Linea - GoldRush API Documentation](#linea-goldrush-api-documentation) - [Arbitrum Nova - GoldRush API Documentation](#arbitrum-nova-goldrush-api-documentation) - [ZetaChain - GoldRush API Documentation](#zetachain-goldrush-api-documentation) - [Base - GoldRush API Documentation](#base-goldrush-api-documentation) - [zkSync Era - GoldRush API Documentation](#zksync-era-goldrush-api-documentation) - [opBNB - GoldRush API Documentation](#opbnb-goldrush-api-documentation) - [Get activity across all chains for address - GoldRush API Documentation](#get-activity-across-all-chains-for-address-goldrush-api-documentation) - [Get Bitcoin balances for HD address - GoldRush API Documentation](#get-bitcoin-balances-for-hd-address-goldrush-api-documentation) - [Get historical Bitcoin balance for non-HD address - GoldRush API Documentation](#get-historical-bitcoin-balance-for-non-hd-address-goldrush-api-documentation) - [Get Bitcoin transactions for non-HD address - GoldRush API Documentation](#get-bitcoin-transactions-for-non-hd-address-goldrush-api-documentation) - [Get resolved address for registered address - GoldRush API Documentation](#get-resolved-address-for-registered-address-goldrush-api-documentation) - [Page Not Found](#page-not-found) - [Get native token balance for address - GoldRush API Documentation](#get-native-token-balance-for-address-goldrush-api-documentation) - [Get historical token prices - GoldRush API Documentation](#get-historical-token-prices-goldrush-api-documentation) - [Get historical portfolio value over time - GoldRush API Documentation](#get-historical-portfolio-value-over-time-goldrush-api-documentation) - [Get ERC20 token transfers for address - GoldRush API Documentation](#get-erc20-token-transfers-for-address-goldrush-api-documentation) - [Get a transaction - GoldRush API Documentation](#get-a-transaction-goldrush-api-documentation) - [Get all transactions in a block by page (v3) - GoldRush API Documentation](#get-all-transactions-in-a-block-by-page-v3-goldrush-api-documentation) - [Get earliest transactions for address (v3) - GoldRush API Documentation](#get-earliest-transactions-for-address-v3-goldrush-api-documentation) - [Get all chain statuses - GoldRush API Documentation](#get-all-chain-statuses-goldrush-api-documentation) - [Get all chains - GoldRush API Documentation](#get-all-chains-goldrush-api-documentation) - [Get a block - GoldRush API Documentation](#get-a-block-goldrush-api-documentation) - [Get all transactions in a block (v3) - GoldRush API Documentation](#get-all-transactions-in-a-block-v3-goldrush-api-documentation) - [Get paginated transactions for address (v3) - GoldRush API Documentation](#get-paginated-transactions-for-address-v3-goldrush-api-documentation) - [Get recent transactions for address (v3) - GoldRush API Documentation](#get-recent-transactions-for-address-v3-goldrush-api-documentation) - [Get bulk time bucket transactions for address (v3) - GoldRush API Documentation](#get-bulk-time-bucket-transactions-for-address-v3-goldrush-api-documentation) - [Get block heights - GoldRush API Documentation](#get-block-heights-goldrush-api-documentation) - [Get gas prices - GoldRush API Documentation](#get-gas-prices-goldrush-api-documentation) - [Get log events by topic hash(es) - GoldRush API Documentation](#get-log-events-by-topic-hash-es-goldrush-api-documentation) - [Get log events by contract address - GoldRush API Documentation](#get-log-events-by-contract-address-goldrush-api-documentation) - [Get historical token balances for address - GoldRush API Documentation](#get-historical-token-balances-for-address-goldrush-api-documentation) --- # What is GoldRush - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/overview#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... Ctrl K Search... Navigation Learn about GoldRush What is GoldRush [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Pick your Use Case](https://goldrush.dev/docs/overview#pick-your-use-case) Whether you’re building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, our Blockchain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. GoldRush indexes the entire chain data, from the genesis block to the latest block, across multiple data types: balances, transactions, logs, internal transfers, pricing, and smart contract events. You get complete, verifiable coverage without running your own node infrastructure. [​](https://goldrush.dev/docs/overview#pick-your-use-case) Pick your Use Case -------------------------------------------------------------------------------- GoldRush offers two core self-serve products that can be used independently or together to power your application. [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](https://goldrush.dev/docs/goldrush-foundational-api) [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](https://goldrush.dev/docs/goldrush-streaming-api) [Powered by GoldRush](https://goldrush.dev/docs/powered-by-goldrush) Ctrl+I Assistant Responses are generated using AI and may contain mistakes. --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/goldrush-apis#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [What is GoldRush](https://goldrush.dev/docs/overview#what-is-goldrush) [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks#) [GoldRush MCP Server](https://goldrush.dev/docs/goldrush-mcp-server#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/goldrush-ui-kit#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [What is GoldRush](https://goldrush.dev/docs/overview#what-is-goldrush) [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks#) [GoldRush MCP Server](https://goldrush.dev/docs/goldrush-mcp-server#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/quickstart#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Quickstart](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#) [GoldRush MCP Server](https://goldrush.dev/docs/goldrush-mcp-server#step-2-configure-with-mcp-clients) [Supported Chains](https://goldrush.dev/docs/chains/overview#quick-start) ⌘I --- # GoldRush SDKs - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-sdks#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Components GoldRush SDKs [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) The GoldRush SDKs are official open-source client libraries that wrap around the GoldRush APIs, providing developers with more seamless options to access onchain data. The following client libraries are currently provided: 1. **TypeScript:** [https://www.npmjs.com/package/@covalenthq/client-sdk](https://www.npmjs.com/package/@covalenthq/client-sdk) 2. **Python:** [https://pypi.org/project/covalent-api-sdk/](https://pypi.org/project/covalent-api-sdk/) [Changelog](https://goldrush.dev/docs/changelog) [GoldRush MCP Server](https://goldrush.dev/docs/goldrush-mcp-server) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/goldrush-decoder#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [What is GoldRush](https://goldrush.dev/docs/overview#what-is-goldrush) [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks#) [GoldRush MCP Server](https://goldrush.dev/docs/goldrush-mcp-server#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/cross-chain/get-allchains-balances#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get multichain balances](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-balances#) [Token Balances Stream](https://goldrush.dev/docs/goldrush-streaming-api/token-balances-stream#token-balances-stream) [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/overview#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Overview](https://goldrush.dev/docs/goldrush-foundational-api/overview#) [Axie/Ronin](https://goldrush.dev/docs/chains/axie-ronin#overview) [Bitcoin](https://goldrush.dev/docs/chains/bitcoin#overview) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/cross-chain/get-address-activity#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get activity across all chains for address](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#) [Changelog](https://goldrush.dev/docs/changelog#upgrade-to-cross-chain-address-activity-api) [Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-historical-token-balances-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#) [Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#) [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-token-balances-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#) [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#) [Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/cross-chain/get-allchains-transactions#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get multichain & multiaddress transactions](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-transactions#) [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) [Changelog](https://goldrush.dev/docs/changelog#upgrade-to-cross-chain-address-activity-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-erc20-token-transfers-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#) [Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#) [Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/faq#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Authentication](https://goldrush.dev/docs/goldrush-streaming-api/authentication#5-frequently-asked-questions-faq) [Changelog](https://goldrush.dev/docs/changelog#streaming-api-launch) [HyperCore](https://goldrush.dev/docs/chains/hypercore#supported-apis) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-a-transaction#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-native-token-balance#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#) [Token Balances Stream](https://goldrush.dev/docs/goldrush-streaming-api/token-balances-stream#token-balances-stream) [Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-earliest-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) [Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-transaction-summary-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-historical-portfolio-value-over-time#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#) [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#) [Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-recent-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-token-holders-as-of-any-block-height-v2#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2#) [Token Balances Stream](https://goldrush.dev/docs/goldrush-streaming-api/token-balances-stream#token-balances-stream) [Gnosis](https://goldrush.dev/docs/chains/gnosis#wallet-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-paginated-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-all-transactions-in-a-block-by-page#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#) [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-time-bucket-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-nft-token-ids-for-contract-with-metadata#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get single NFT from contract with metadata](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-metadata-token-id-contract#) [Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2#) [Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-all-transactions-in-a-block#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) [Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-nfts-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#) [Gnosis](https://goldrush.dev/docs/chains/gnosis#nft-api) [Polygon](https://goldrush.dev/docs/chains/polygon#nft-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-nft-metadata-token-id-contract#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get single NFT from contract with metadata](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-metadata-token-id-contract#) [Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2#) [Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-nft-transactions-contract#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get NFT transactions for contract](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-transactions-contract#) [Get single NFT from contract with metadata](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-metadata-token-id-contract#) [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-attribute-values-collection-trait#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get attributes for a collection trait](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-attribute-values-collection-trait#) [Get trait summary for collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-collection-trait-summary#) [Get traits for a collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-list-of-traits-collection#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-collection-trait-summary#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get trait summary for collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-collection-trait-summary#) [Get attributes for a collection trait](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-attribute-values-collection-trait#) [Get traits for a collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-list-of-traits-collection#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-list-of-traits-collection#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get attributes for a collection trait](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-attribute-values-collection-trait#) [Get trait summary for collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-collection-trait-summary#) [Get traits for a collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-list-of-traits-collection#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-chain-collections#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get chain collections](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-chain-collections#) [Request NFT Collection Cache](https://goldrush.dev/docs/api-reference/foundational-api/nft/request-nft-collection-cache#) [Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-nft-market-floor-price#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get historical floor prices for a collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nft-market-floor-price#) [NFT Supported Formats](https://goldrush.dev/docs/resources/nft-supported-formats#nft-supported-formats) [Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/check-ownership-in-nft-collection#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection#) [Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token#) [Gnosis](https://goldrush.dev/docs/chains/gnosis#nft-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-nft-market-sale-count#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [NFT Supported Formats](https://goldrush.dev/docs/resources/nft-supported-formats#nft-supported-formats) [Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#) [Base](https://goldrush.dev/docs/chains/base#nft-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/security/get-token-approvals-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#) [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#) [Avalanche C-Chain](https://goldrush.dev/docs/chains/avalanche-c-chain#security-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/check-ownership-in-nft-collection-token#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token#) [Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection#) [Gnosis](https://goldrush.dev/docs/chains/gnosis#nft-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/security/get-nft-approvals#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get NFT approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-nft-approvals#) [Avalanche C-Chain](https://goldrush.dev/docs/chains/avalanche-c-chain#security-api) [BNB Smart Chain (BSC)](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#security-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/transactions/get-transactions-for-bitcoin-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get Bitcoin transactions for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/nft/get-nft-market-volume#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [NFT Supported Formats](https://goldrush.dev/docs/resources/nft-supported-formats#nft-supported-formats) [Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#) [Ethereum](https://goldrush.dev/docs/chains/ethereum#nft-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-bitcoin-balances-for-hd-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get Bitcoin balances for HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#) [Get Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#) [Get historical Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-pool-spot-prices#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Changelog](https://goldrush.dev/docs/changelog#new-dex-pool-spot-prices-api) [Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices#) [BNB Smart Chain (BSC)](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#pricing-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-log-events-by-contract-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#) [GoldRush MCP Server](https://goldrush.dev/docs/goldrush-mcp-server#utility) [Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/balances/get-bitcoin-balance-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get Bitcoin balances for HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#) [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#) [Get Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-historical-token-prices#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#) [Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#) [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#ohlcv-tokens-stream) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-block-heights#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2#) [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) [Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-logs#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-log-events-by-topic-hash#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#) [GoldRush MCP Server](https://goldrush.dev/docs/goldrush-mcp-server#utility) [Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-gas-prices#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#) [Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#) [Polygon](https://goldrush.dev/docs/chains/polygon#block-explorer-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-all-chains#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get activity across all chains for address](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#) [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) [ADI Chain](https://goldrush.dev/docs/chains/adi-chain#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-a-block#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#) [Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2#) [Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-all-chain-statuses#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses#) [Get activity across all chains for address](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#) [Mantle](https://goldrush.dev/docs/chains/mantle#block-explorer-api) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/api-reference/utility/get-resolved-address-for-registered-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Get resolved address for registered address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#) ⌘I --- # Powered by GoldRush - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/powered-by-goldrush#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Learn about GoldRush Powered by GoldRush [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Crypto Wallets](https://goldrush.dev/docs/powered-by-goldrush#crypto-wallets) * [Crypto Tax Providers](https://goldrush.dev/docs/powered-by-goldrush#crypto-tax-providers) * [DEX](https://goldrush.dev/docs/powered-by-goldrush#dex) * [AI Agents](https://goldrush.dev/docs/powered-by-goldrush#ai-agents) * [DAO Tooling](https://goldrush.dev/docs/powered-by-goldrush#dao-tooling) * [RWAs](https://goldrush.dev/docs/powered-by-goldrush#rwas) [​](https://goldrush.dev/docs/powered-by-goldrush#crypto-wallets) Crypto Wallets ----------------------------------------------------------------------------------- ![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1670704458-rainbow.png&w=256&q=75)![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1727474273-thorwallet.png&w=256&q=75) [​](https://goldrush.dev/docs/powered-by-goldrush#crypto-tax-providers) Crypto Tax Providers ----------------------------------------------------------------------------------------------- ![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1692386448-cryptotaxcalculator.png&w=256&q=75)![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1728583605-integral.png&w=256&q=75)![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1674079752-koinly.png&w=256&q=75) [​](https://goldrush.dev/docs/powered-by-goldrush#dex) DEX ------------------------------------------------------------- ![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1675290157-matcha.png&w=256&q=75)![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1753487448-velora.png&w=256&q=75) [​](https://goldrush.dev/docs/powered-by-goldrush#ai-agents) AI Agents ------------------------------------------------------------------------- ![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1738793653-sphereone.png&w=256&q=75) [​](https://goldrush.dev/docs/powered-by-goldrush#dao-tooling) DAO Tooling ----------------------------------------------------------------------------- ![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1738792249-guild.png&w=256&q=75)![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1738793654-yieldguildgames.png&w=256&q=75) [​](https://goldrush.dev/docs/powered-by-goldrush#rwas) RWAs --------------------------------------------------------------- ![](https://goldrush.dev/_next/image/?url=https%3A%2F%2Fwww.datocms-assets.com%2F86369%2F1727474273-ondo-finance.png&w=256&q=75) [What is GoldRush](https://goldrush.dev/docs/overview) [Frequently Asked Questions](https://goldrush.dev/docs/faq) ⌘I --- # Frequently Asked Questions - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/faq#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Learn about GoldRush Frequently Asked Questions [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [General Questions](https://goldrush.dev/docs/faq#general-questions) * [What is the GoldRush API?](https://goldrush.dev/docs/faq#what-is-the-goldrush-api) * [What can I do with the GoldRush API?](https://goldrush.dev/docs/faq#what-can-i-do-with-the-goldrush-api) * [Do I need API keys to use GoldRush?](https://goldrush.dev/docs/faq#do-i-need-api-keys-to-use-goldrush) * [If a client asks how to verify that GoldRush API is real-time or low-latency, how can we demonstrate or prove that?](https://goldrush.dev/docs/faq#if-a-client-asks-how-to-verify-that-goldrush-api-is-real-time-or-low-latency%2C-how-can-we-demonstrate-or-prove-that) * [Besides the common 401, 402, and 429 error codes, are there any other error responses we should be aware of?](https://goldrush.dev/docs/faq#besides-the-common-401%2C-402%2C-and-429-error-codes%2C-are-there-any-other-error-responses-we-should-be-aware-of) * [Foundational API Questions](https://goldrush.dev/docs/faq#foundational-api-questions) * [What is the rate limit for API calls?](https://goldrush.dev/docs/faq#what-is-the-rate-limit-for-api-calls) * [Streaming API Questions](https://goldrush.dev/docs/faq#streaming-api-questions) * [How does the Streaming API work?](https://goldrush.dev/docs/faq#how-does-the-streaming-api-work) * [What types of events can I subscribe to?](https://goldrush.dev/docs/faq#what-types-of-events-can-i-subscribe-to) [​](https://goldrush.dev/docs/faq#general-questions) General Questions ------------------------------------------------------------------------- ### [​](https://goldrush.dev/docs/faq#what-is-the-goldrush-api) What is the GoldRush API? GoldRush offers the most comprehensive Blockchain Data API suite for developers, analysts, and enterprises. ### [​](https://goldrush.dev/docs/faq#what-can-i-do-with-the-goldrush-api) What can I do with the GoldRush API? The GoldRush API provdes fast, accurate, and developer-friendly access to the essential onchain data for building DeFi dashboards, wallets, trading bots, AI Agents, tax and compliance platforms. ### [​](https://goldrush.dev/docs/faq#do-i-need-api-keys-to-use-goldrush) Do I need API keys to use GoldRush? Yes, you need an API key to access the GoldRush API. Your API Key is available on the [GoldRush platform](https://goldrush.dev/docs/platform) when you sign up for an account. ### [​](https://goldrush.dev/docs/faq#if-a-client-asks-how-to-verify-that-goldrush-api-is-real-time-or-low-latency,-how-can-we-demonstrate-or-prove-that) If a client asks how to verify that GoldRush API is real-time or low-latency, how can we demonstrate or prove that? You can demonstrate real-time or low-latency capabilities through: * Timestamp validation: Pull `/v1/{chain_id}/block_v2/latest/` and compare the block timestamp with the current time (should be sub-second to a few seconds behind depending on chain). * Latency benchmarks: Use tools like curl or Postman to measure API response time. GoldRush’s streaming endpoints often respond in under 400ms for supported chains. * Streaming demos: If using the Streaming API, show live updates of token transfers or block finality in dev dashboards. ### [​](https://goldrush.dev/docs/faq#besides-the-common-401,-402,-and-429-error-codes,-are-there-any-other-error-responses-we-should-be-aware-of) Besides the common 401, 402, and 429 error codes, are there any other error responses we should be aware of? Yes. Additional error codes include: * `400 Bad Request` – Invalid parameters or malformed request. * `402 Payment Required` – Alloted credits exceeded and need to enable Flex Credits or upgrade subscription tier. * `403 Forbidden` – API key is valid but not authorized for the resource. * `404 Not Found` – Endpoint or data not available (e.g. unsupported chain). * `500 Internal Server Error` – Unexpected failure on Covalent’s side. * `503 Service Unavailable` – Maintenance or backend issue. Each error includes a descriptive JSON body for debugging. [​](https://goldrush.dev/docs/faq#foundational-api-questions) Foundational API Questions ------------------------------------------------------------------------------------------- ### [​](https://goldrush.dev/docs/faq#what-is-the-rate-limit-for-api-calls) What is the rate limit for API calls? The GoldRush Foundational API enforces rate limits based on the user’s plan: * 14-day Free Trial plan: 4 requests per second (RPS), 25,000 API credits. * Professional plan: 50 RPS. * Inner Circle plan: Custom limits, typically up to 100 RPS or higher, based on SLAs. Rate limits are enforced per API key and IP, and requests exceeding limits receive a `429 Too Many Requests` error. [​](https://goldrush.dev/docs/faq#streaming-api-questions) Streaming API Questions ------------------------------------------------------------------------------------- ### [​](https://goldrush.dev/docs/faq#how-does-the-streaming-api-work) How does the Streaming API work? The Streaming API uses WebSocket connections to provide real-time updates about blockchain events. It maintains a persistent connection and pushes structured data to subscribed clients as events occur. ### [​](https://goldrush.dev/docs/faq#what-types-of-events-can-i-subscribe-to) What types of events can I subscribe to? See all available streams on the [Streaming API Overview](https://goldrush.dev/docs/goldrush-streaming-api/overview) . [Powered by GoldRush](https://goldrush.dev/docs/powered-by-goldrush) [Changelog](https://goldrush.dev/docs/changelog) ⌘I --- # GoldRush MCP Server - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-mcp-server#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Components GoldRush MCP Server [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Setup Instructions](https://goldrush.dev/docs/goldrush-mcp-server#setup-instructions) * [Step 1: Installation](https://goldrush.dev/docs/goldrush-mcp-server#step-1%3A-installation) * [Step 2: Configure with MCP clients](https://goldrush.dev/docs/goldrush-mcp-server#step-2%3A-configure-with-mcp-clients) * [Step 3: Programmatic Usage](https://goldrush.dev/docs/goldrush-mcp-server#step-3%3A-programmatic-usage) * [Available Tools](https://goldrush.dev/docs/goldrush-mcp-server#available-tools) * [Available Resources](https://goldrush.dev/docs/goldrush-mcp-server#available-resources) * [Example LLM Interaction](https://goldrush.dev/docs/goldrush-mcp-server#example-llm-interaction) The GoldRush MCP Server provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) implementation that exposes GoldRush APIs as MCP resources and tools. It enables LLMs to interact with blockchain data across multiple chains. You’ll need a GoldRush API key to use this server. [Get Started\ -----------\ \ Sign up for a free API key to get started with GoldRush.](https://goldrush.dev/platform/auth/register/) [​](https://goldrush.dev/docs/goldrush-mcp-server#setup-instructions) Setup Instructions ------------------------------------------------------------------------------------------- ### [​](https://goldrush.dev/docs/goldrush-mcp-server#step-1:-installation) Step 1: Installation No installation is needed as the server can be run directly using `npx`. ### [​](https://goldrush.dev/docs/goldrush-mcp-server#step-2:-configure-with-mcp-clients) Step 2: Configure with MCP clients 1 Usage with Claude Desktop Add this to your `claude_desktop_config.json`: Copy Ask AI { "mcpServers": { "goldrush": { "command": "npx", "args": [\ "-y",\ "@covalenthq/goldrush-mcp-server@latest"\ ], "env": { "GOLDRUSH_API_KEY": "YOUR_API_KEY_HERE" } } } } For more details, follow the official [MCP Quickstart for Claude Desktop Users](https://modelcontextprotocol.io/quickstart/user) . 2 Usage with Claude Code CLI Copy Ask AI $ claude mcp add goldrush -e GOLDRUSH_API_KEY= -- npx @covalenthq/goldrush-mcp-server For more details, see [Set up Model Context Protocol (MCP)](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) . 3 Usage with Cursor 1. Open Cursor Settings 2. Go to Features > MCP 3. Click + Add new global MCP server 4. Add this to your `~/.cursor/mcp.json`: Copy Ask AI { "mcpServers": { "goldrush": { "command": "npx", "args": [\ "-y",\ "@covalenthq/goldrush-mcp-server@latest"\ ], "env": { "GOLDRUSH_API_KEY": "YOUR_API_KEY_HERE" } } } } For project-specific configuration, add the above to a `.cursor/mcp.json` file in your project directory. 4 Usage with Windsurf Add this to your `~/.codeium/windsurf/mcp_config.json` file: Copy Ask AI { "mcpServers": { "goldrush": { "command": "npx", "args": [\ "-y",\ "@covalenthq/goldrush-mcp-server@latest"\ ], "env": { "GOLDRUSH_API_KEY": "YOUR_API_KEY_HERE" } } } } ### [​](https://goldrush.dev/docs/goldrush-mcp-server#step-3:-programmatic-usage) Step 3: Programmatic Usage The server is designed to be started as a subprocess by an MCP client. Here’s an example using the MCP TypeScript SDK: Copy Ask AI import { Client } from "@modelcontextprotocol/sdk/client/index.js"; import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"; const transport = new StdioClientTransport({ command: "npx", args: ["-y", "@covalenthq/goldrush-mcp-server@latest"], env: {"GOLDRUSH_API_KEY": "your_api_key_here"} }); const client = new Client( { name: "example-client", version: "1.0.0" }, { capabilities: { tools: {} } } ); await client.connect(transport); // List tools const resources = await client.listTools(); const tools = await client.listTools(); console.log("Available tools:", tools.tools.map(tool => tool.name).join(", ")); // Now you can call tools const result = await client.callTool({ name: "getAllChains", arguments: {} }); console.log(result); [​](https://goldrush.dev/docs/goldrush-mcp-server#available-tools) Available Tools ------------------------------------------------------------------------------------- The GoldRush MCP Server exposes over 50 tools for interacting with blockchain data. Here are some of the most commonly used tools: Cross Chain * **multichain\_address\_activity**: Gets a summary of wallet activity across all supported blockchains. * **multichain\_balances**: Gets token balances for a wallet address across multiple blockchains. * **multichain\_transactions**: Gets transactions for multiple wallet addresses across multiple blockchains. Balances * **token\_balances**: Commonly used to fetch the native and fungible (ERC20) tokens held by an address. * **historical\_token\_balances**: Commonly used to fetch the historical native and fungible (ERC20) tokens held by an address at a given block height or date. * **native\_token\_balance**: Get the native token balance (ETH, BNB, MATIC, etc.) for a specified wallet address on a blockchain. * **erc20\_token\_transfers**: Commonly used to render the transfer-in and transfer-out of a token along with historical prices from an address. * **historical\_portfolio\_value**: Commonly used to render a daily portfolio balance for an address broken down by the token. * **token\_holders**: Used to get a paginated list of current or historical token holders for a specified ERC20 or ERC721 token. Transaction * **transaction**: Commonly used to fetch and render a single transaction including its decoded log events. * **transaction\_summary**: Commonly used to fetch the earliest and latest transactions, and the transaction count for a wallet. * **transactions\_for\_address**: Commonly used to fetch and render the most recent transactions involving an address. * **transactions\_for\_block**: Commonly used to fetch all transactions including their decoded log events in a block and further flag interesting wallets or transactions. NFT * **nft\_for\_address**: Commonly used to get all NFTs owned by a specific wallet address on a blockchain. * **nft\_check\_ownership**: Commonly used to verify ownership of NFTs (including ERC-721 and ERC-1155) within a collection. Security * **token\_approvals**: Commonly used to get a list of approvals across all token contracts categorized by spenders for a wallet’s assets. Bitcoin * **bitcoin\_hd\_wallet\_balances**: Fetch balances for each active child address derived from a Bitcoin HD wallet. * **bitcoin\_non\_hd\_wallet\_balances**: Fetch Bitcoin balance for a non-HD address. * **bitcoin\_transactions**: Fetch transactions for a specific Bitcoin address with full transaction details. Prices * **historical\_token\_prices**: Commonly used to get historic prices of a token between date ranges. * **gas\_prices**: Get real-time gas estimates for different transaction speeds on a specific network. Utility * **log\_events\_by\_address**: Commonly used to get all the event logs emitted from a particular contract address. * **log\_events\_by\_topic**: Commonly used to get all event logs of the same topic hash across all contracts within a particular chain. * **block**: Commonly used to fetch and render a single block for a block explorer. * **block\_heights**: Commonly used to get all the block heights within a particular date range. Visit our [GitHub repository](https://github.com/covalenthq/goldrush-mcp-server) for a complete list of tools and their parameters. [​](https://goldrush.dev/docs/goldrush-mcp-server#available-resources) Available Resources --------------------------------------------------------------------------------------------- Resources are a core primitive in the Model Context Protocol that allow servers to expose data and content for use as context in LLM interactions. The GoldRush MCP Server provides both static and dynamic resources: Static Resources * **config://supported-chains**: Provides a list of all blockchain networks supported by the GoldRush API * **config://quote-currencies**: Provides a list of all supported quote currencies for price conversions Dynamic Resources * **status://all-chains**: Provides real-time synchronization status for all chains * **status://chain/**: Provides detailed status information for a specific chain Dynamic resources fetch real-time data from the GoldRush API on each request, ensuring current information. [​](https://goldrush.dev/docs/goldrush-mcp-server#example-llm-interaction) Example LLM Interaction ----------------------------------------------------------------------------------------------------- Once you’ve set up the GoldRush MCP Server with your preferred LLM client, you can start asking blockchain-related questions: * “What are the top tokens in this Ethereum wallet: 0xeefB13C7D42eFCc655E528dA6d6F7bBcf9A2251d?” * “Show me the transaction history for this wallet address on Polygon.” * “What NFTs does this wallet own across multiple chains?” * “Get the gas prices for ERC20 transfers on Ethereum mainnet.” The LLM will automatically use the appropriate GoldRush MCP tools to retrieve the blockchain data and provide you with informative responses. [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks) ⌘I --- # Overview - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-foundational-api/overview#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation GoldRush Foundational API Overview [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Use Cases](https://goldrush.dev/docs/goldrush-foundational-api/overview#use-cases) [​](https://goldrush.dev/docs/goldrush-foundational-api/overview#use-cases) Use Cases ---------------------------------------------------------------------------------------- [![1750700004-goldrush-images-03](https://www.datocms-assets.com/86369/1750700004-goldrush-images-03.png)\ \ Wallet API\ ----------\ \ Multichain token balances (ERC20, 721, 1155, native), token transfers and prices (spot and historical) for a wallet.\ \ API Reference](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) [![1750700004-goldrush-images-04](https://www.datocms-assets.com/86369/1750700004-goldrush-images-04.png)\ \ Activity Feed API\ -----------------\ \ Multichain historical transactions with human-readable event logs and historical prices. Includes transaction count and gas usage/spend summaries.\ \ API Reference](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) [![1750700004-goldrush-images-05](https://www.datocms-assets.com/86369/1750700004-goldrush-images-05.png)\ \ NFT API\ -------\ \ Media assets, metadata, sales, owners, trait and attribute filters, thumbnail previews.\ \ API Reference](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) [![1750700004-goldrush-images-02](https://www.datocms-assets.com/86369/1750700004-goldrush-images-02.png)\ \ Bitcoin API\ -----------\ \ Bitcoin balances and transactions for x/y/zpub and non-HD addresses, including historical and spot prices.\ \ API Reference](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address) [![1750700004-goldrush-images-07](https://www.datocms-assets.com/86369/1750700004-goldrush-images-07.png)\ \ Security API\ ------------\ \ NFT and ERC20 token allowances, including value-at-risk.\ \ API Reference](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) [![1750700004-goldrush-images-08](https://www.datocms-assets.com/86369/1750700004-goldrush-images-08.png)\ \ Block Explorer API\ ------------------\ \ Block details, event logs by contract address or topic hash, gas prices, token prices & holders.\ \ API Reference](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) [Quickstart](https://goldrush.dev/docs/goldrush-foundational-api/quickstart) ⌘I --- # Changelog - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/changelog#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [December 10, 2025](https://goldrush.dev/docs/changelog#december-10%2C-2025) * [December 4, 2025](https://goldrush.dev/docs/changelog#december-4%2C-2025) * [November 24, 2025](https://goldrush.dev/docs/changelog#november-24%2C-2025) * [November 5, 2025](https://goldrush.dev/docs/changelog#november-5%2C-2025) * [October 29, 2025](https://goldrush.dev/docs/changelog#october-29%2C-2025) * [September 8, 2025](https://goldrush.dev/docs/changelog#september-8%2C-2025) * [August 13, 2025](https://goldrush.dev/docs/changelog#august-13%2C-2025) * [July 28, 2025](https://goldrush.dev/docs/changelog#july-28%2C-2025) * [July 22, 2025](https://goldrush.dev/docs/changelog#july-22%2C-2025) * [July 10, 2025](https://goldrush.dev/docs/changelog#july-10%2C-2025) * [July 3, 2025](https://goldrush.dev/docs/changelog#july-3%2C-2025) * [June 4, 2025](https://goldrush.dev/docs/changelog#june-4%2C-2025) * [May 21, 2025](https://goldrush.dev/docs/changelog#may-21%2C-2025) * [April 14, 2025](https://goldrush.dev/docs/changelog#april-14%2C-2025) * [April 4, 2025](https://goldrush.dev/docs/changelog#april-4%2C-2025) * [March 31, 2025](https://goldrush.dev/docs/changelog#march-31%2C-2025) * [February 20, 2025](https://goldrush.dev/docs/changelog#february-20%2C-2025) * [February 20, 2025](https://goldrush.dev/docs/changelog#february-20%2C-2025-2) * [February 1, 2025](https://goldrush.dev/docs/changelog#february-1%2C-2025) * [January 29, 2025](https://goldrush.dev/docs/changelog#january-29%2C-2025) * [December 12, 2024](https://goldrush.dev/docs/changelog#december-12%2C-2024) * [December 10, 2024](https://goldrush.dev/docs/changelog#december-10%2C-2024) * [November 18, 2024](https://goldrush.dev/docs/changelog#november-18%2C-2024) * [November 18, 2024](https://goldrush.dev/docs/changelog#november-18%2C-2024-2) * [October 18, 2024](https://goldrush.dev/docs/changelog#october-18%2C-2024) * [October 16, 2024](https://goldrush.dev/docs/changelog#october-16%2C-2024) * [September 30, 2024](https://goldrush.dev/docs/changelog#september-30%2C-2024) * [September 20, 2024](https://goldrush.dev/docs/changelog#september-20%2C-2024) * [September 1, 2024](https://goldrush.dev/docs/changelog#september-1%2C-2024) * [July 31, 2024](https://goldrush.dev/docs/changelog#july-31%2C-2024) [​](https://goldrush.dev/docs/changelog#december-10%2C-2025) December 10, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#adi-chain-mainnet-now-supported) ADI Chain Mainnet Now Supported =========================================================================================================== ![ADI Chain Mainnet Now Supported](https://www.datocms-assets.com/86369/1764875125-chain-integration-adi-chain.jpg)ADI Chain mainnet is now indexed and available via the GoldRush Foundational API. Here are the chain details for the supported networks: | Chain | Chain Name | Chain ID | | --- | --- | --- | | ADI Mainnet | adi-mainnet | 36900 | | ADI Testnet | adi-testnet | 99999 | ADI Chain is classified as a ‘Frontier Chain’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs.[Learn more](https://goldrush.dev/docs/chains/adi-chain) [​](https://goldrush.dev/docs/changelog#december-4%2C-2025) December 4, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#arc-testnet-now-supported) Arc Testnet Now Supported =============================================================================================== ![Arc Testnet Now Supported](https://www.datocms-assets.com/86369/1764883890-chain-integration-arc.jpg)Arc Testnet is now indexed and available via the GoldRush Foundational API. Here is the chain details for the supported network: | Chain | Chain Name | Chain ID | | --- | --- | --- | | Arc Testnet | arc-testnet | 5042002 | Arc Testnet is classified as a ‘Frontier Chain’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs.[Learn more](https://goldrush.dev/docs/chains/arc) [​](https://goldrush.dev/docs/changelog#november-24%2C-2025) November 24, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#monad-mainnet-now-supported) Monad Mainnet Now Supported =================================================================================================== ![Monad Mainnet Now Supported](https://www.datocms-assets.com/86369/1763771705-chain-integration-monad-mainnet.jpg)Monad Mainnet is now indexed and available via the GoldRush Foundational API and Streaming API. Here are the chain details for the supported networks: | Chain | Chain Name | Chain ID | | --- | --- | --- | | Monad Mainnet | monad-mainnet | 143 | | Monad Testnet | monad-testnet | 10143 | Monad is classified as a ‘Frontier Chain’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs. Additionally, Monad Mainnet support has been added to the Streaming API for all streams except for the Token Balances Stream.[Learn more](https://goldrush.dev/docs/chains/monad) [​](https://goldrush.dev/docs/changelog#november-5%2C-2025) November 5, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#supported-chains-update) Supported Chains Update =========================================================================================== As we do regularly, our list of supported chains has been updated after pruning defunct, legacy or low-activity chains. The removed chains include: * Aurora * Boba * Dexalot * DeFi Kingdoms * Fraxtal * Horizen EON * Metis * Palm * Polygon zkEVM * Zora See the link below for the full updated listof supported chains.[Learn more](https://goldrush.dev/docs/chains) [​](https://goldrush.dev/docs/changelog#october-29%2C-2025) October 29, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#plasma-chain-now-supported) Plasma Chain Now Supported ================================================================================================= ![Plasma Chain Now Supported](https://www.datocms-assets.com/86369/1761763662-chain-integration-plasma.jpg)Plasma Mainnet and Testnet are now indexed and available via the GoldRush Foundational API. Here are the chain details for the supported networks: | Chain | Chain Name | Chain ID | | --- | --- | --- | | Plasma Mainnet | plasma-mainnet | 9745 | | Plasma Testnet | plasma-testnet | 9746 | Plasma is classified as a ‘Frontier Chain’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs.[Learn more](https://goldrush.dev/docs/chains/plasma) [​](https://goldrush.dev/docs/changelog#september-8%2C-2025) September 8, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#sonic-chain-now-supported) Sonic Chain Now Supported =============================================================================================== ![Sonic Chain Now Supported](https://www.datocms-assets.com/86369/1757357438-chain-integration-sonic.jpg)Sonic Mainnet is now indexed and available via the GoldRush Foundational API and Streaming API. Here are the chain details for the supported networks: | Chain | Chain Name | Chain ID | | --- | --- | --- | | Sonic Mainnet | sonic-mainnet | 146 | Sonic is classified as a ‘Frontier Chain’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs. Additionally, Sonic support has been added to the Streaming API for all streams except for the Token Balances Stream.[Learn more](https://goldrush.dev/docs/chains/sonic) [​](https://goldrush.dev/docs/changelog#august-13%2C-2025) August 13, 2025 Streaming API [​](https://goldrush.dev/docs/changelog#update-pairs-stream-beta) Update Pairs Stream (Beta) =============================================================================================== The new Update Pairs stream delivers real-time updates for one or many DEX pairs, including price, price in USD, volume, market cap, and liquidity. * Supported chains: Base Mainnet, BSC Mainnet, Ethereum Mainnet * Supported DEXes: Uniswap V2, Uniswap V3, PancakeSwap * Subscribe with `updatePairs(chain_name, pair_addresses[])` over GraphQL Note: The GoldRush Streaming API is currently in Beta. No API credits are currently charged.[Learn more](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs) [​](https://goldrush.dev/docs/changelog#july-28%2C-2025) July 28, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#hyperevm-mainnet-now-supported) HyperEVM Mainnet Now Supported ========================================================================================================= ![HyperEVM Mainnet Now Supported](https://www.datocms-assets.com/86369/1753463511-blockchains-indexed-1_july_2025.jpg)Hyperliquid’s HyperEVM Mainnet is now indexed and available via the GoldRush Foundational API. Here are the chain details for the supported mainnet: | Chain | Chain Name | Chain ID | | --- | --- | --- | | HyperEVM Mainnet | hyperevm-mainnet | 999 | HyperEVM mainnet is classified as ‘Frontier Chains’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs. Extending HyperEVM mainnet support to the Streaming API will be made once a viable websocket is made available.[Learn more](https://goldrush.dev/docs/chains/hyperevm) [​](https://goldrush.dev/docs/changelog#july-22%2C-2025) July 22, 2025 Streaming API [​](https://goldrush.dev/docs/changelog#updated-streaming-api-url) Updated Streaming API URL =============================================================================================== The GoldRush Streaming API URL has been updated to support authentication using the GoldRush API key.The updated URL is: `wss://gr-staging-v2.streaming.covalenthq.com/graphql`The prior URL was: `wss://gr-staging.streaming.covalenthq.com/graphql`See the [Streaming API Docs](https://goldrush.dev/docs/goldrush-streaming-api/overview) for more details.[Learn more](https://goldrush.dev/docs/goldrush-streaming-api/quickstart) [​](https://goldrush.dev/docs/changelog#july-10%2C-2025) July 10, 2025 Streaming API [​](https://goldrush.dev/docs/changelog#new-graphql-queries-for-wallet-trading-data) New GraphQL Queries for Wallet Trading Data =================================================================================================================================== ![New GraphQL Queries for Wallet Trading Data](https://www.datocms-assets.com/86369/1752247757-goldrush-streaming-api-new-graphql-queries.jpg)New GraphQL queries, as part of the GoldRush Streaming API, are now available in public Beta. These queries provides real-time insights into wallet trading data and include: * **Get top trading wallets for token**: provides a list of wallets with the highest trading volume for a specific token over the last 30 days, along with detailed information about their holdings, transaction activity, realized and unrealized profit/loss metrics * **Get PnL for wallet**: provides detailed financial metrics, including unrealized and realized profit and loss (PnL), current balance, and transaction insights for each token held by a specific wallet address on a given chain. These queries are ideal for: * Trading platforms that enable copy trading or following strategies of high-performing wallets. * Portfolio trackers and personal finance dashboards. * Trading bots and dashboards that highlight whale wallet activity or smart money moves. **Note:** The GoldRush Streaming API is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#9deee8ededf2efe9ddfef2ebfcf1f8f3e9f5ecb3fef2f0) to us directly to report issues or request features.[Learn more](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token) [​](https://goldrush.dev/docs/changelog#july-3%2C-2025) July 3, 2025 Mcp Server [​](https://goldrush.dev/docs/changelog#goldrush-mcp-server-v0-0-3-multi-transport-support-release) GoldRush MCP Server v0.0.3 - Multi-Transport Support Release =================================================================================================================================================================== ![GoldRush MCP Server v0.0.3 - Multi-Transport Support Release](https://www.datocms-assets.com/86369/1751673289-goldrush-mcp-multi-transport-support-release.jpg)GoldRush MCP Server is a Model Context Protocol server that enables AI applications to access blockchain and cryptocurrency data through a standardized interface. The server provides AI models with secure, structured access to blockchain data and cryptocurrency information, allowing them to answer questions and perform tasks related to digital assets, transactions, and market data. [​](https://goldrush.dev/docs/changelog#previous-limitations) Previous Limitations ------------------------------------------------------------------------------------- Previously, users could only run the GoldRush MCP Server using STDIO transport, which limited deployment flexibility. This meant: * Only command-line and local integrations were possible * No web-based or HTTP API access * Limited options for authentication and security * Fewer deployment scenarios for production environments [​](https://goldrush.dev/docs/changelog#new-capabilities) New Capabilities ----------------------------------------------------------------------------- With this update, users can now: * **Deploy over HTTP**: Run the server as a web service with HTTP transport, enabling web applications and remote integrations * **Choose deployment method**: Select between STDIO (for local/command-line use) or HTTP (for web services) based on their needs * **Secure with authentication**: Use Bearer token authentication for HTTP deployments to protect access * **Customize configurations**: Set custom ports and configure transport settings via command-line arguments * **Integrate more easily**: Connect from web applications, mobile apps, or any system that can make HTTP requests [​](https://goldrush.dev/docs/changelog#impact) Impact --------------------------------------------------------- This release significantly expands how and where GoldRush MCP Server can be deployed, making it more versatile for different use cases from local development to production web services.[Learn more](https://www.npmjs.com/package/@covalenthq/goldrush-mcp-server) [​](https://goldrush.dev/docs/changelog#june-4%2C-2025) June 4, 2025 Streaming API [​](https://goldrush.dev/docs/changelog#streaming-api-launch) Streaming API Launch! ====================================================================================== ![Streaming API Launch!](https://www.datocms-assets.com/86369/1750367006-goldrush-streaming-api.jpg)The GoldRush Streaming API is now available in public Beta! It provides real-time updates on blockchain events, including: * Token balances * New DEX pairs (on Uniswap V2, V3) * Wallet activity * OHLCV token and pair price data. This API is ideal for applications that require immediate notifications or updates on blockchain activities such as: * Trading bots * Gaming * AI agents The API is offered via GraphQL endpoints allowing developers to filter for specific chains, or DEXs and to start real-time subscriptions.**Note:** The GoldRush Streaming API is currently in Beta. It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. No API credits are currently charged.We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#aedddbdedec1dcdaeecdc1d8cfc2cbc0dac6df80cdc1c3) to us directly to report issues or request features.[Learn more](https://goldrush.dev/docs/goldrush-streaming-api/overview) [​](https://goldrush.dev/docs/changelog#may-21%2C-2025) May 21, 2025 Foundational API [​](https://goldrush.dev/docs/changelog#upgrade-to-cross-chain-address-activity-api) Upgrade to Cross Chain Address Activity API =================================================================================================================================== ![Upgrade to Cross Chain Address Activity API](https://www.datocms-assets.com/86369/1750368404-address-activity-improvement.jpg)The Cross Chain Address Activity API has undergone a major performance improvement to significantly reduce the number of timeouts or `503` network error responses. The improvement stems from optimizing the unified query conducted over multiple shards.The Cross Chain Address Activity API does a deep crawl across all supported blockchains to identify which chains a wallet is active on along with a `last_seen_at` timestamp with one API call.[Learn more](https://goldrush.dev/docs/api-reference/cross-chain/get-address-activity) [​](https://goldrush.dev/docs/changelog#april-14%2C-2025) April 14, 2025 Mcp Server [​](https://goldrush.dev/docs/changelog#mcp-server-for-blockchain-data) MCP Server for Blockchain Data ========================================================================================================= ![MCP Server for Blockchain Data](https://www.datocms-assets.com/86369/1750367375-goldrush-mcp-banner.jpg)The GoldRush MCP Server exposes the GoldRush APIs as MCP resources and tools, enabling LLMs to interact with extensive, structured, multichain data.Developers and product teams can leverage the GoldRush MCP server to power AI-driven use-cases such as: * Real-time blockchain analytics and insights directly within conversational AI and assistants. * Enhanced risk assessment and compliance tools powered by AI with live on-chain data feeds. * Dynamic NFT and DeFi marketplaces utilizing AI-driven discovery and recommendation engines based on real-time blockchain activity. * AI Agents: Enable autonomous AI agents to fetch, analyze, and act upon blockchain data in real-time, powering automated trading strategies, monitoring, and governance mechanisms. [Learn more](https://goldrush.dev/docs/goldrush-mcp-server) [​](https://goldrush.dev/docs/changelog#april-4%2C-2025) April 4, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#lens-mainnet-now-supported) Lens Mainnet Now Supported ================================================================================================= ![Lens Mainnet Now Supported](https://www.datocms-assets.com/86369/1750353739-lens-mainnet-integration.jpg)Lens Mainnet is now indexed and available via GoldRush. Here are the chain details for the supported mainnet and testnet: | Chain | Chain Name | Chain ID | | --- | --- | --- | | Lens Mainnet | lens-mainnet | 232 | | Lens Testnet | lens-sepolia-testnet | 37111 | Lens Mainnet & Testnet are classified as ‘Frontier Chains’ meaning comprehensive support for core structured data, including token balances, complete transaction histories and decoded event logs. Lens support also includes NFT caching.[Learn more](https://goldrush.dev/chains/lens/) [​](https://goldrush.dev/docs/changelog#march-31%2C-2025) March 31, 2025 Foundational API [​](https://goldrush.dev/docs/changelog#enhanced-token-spam-lists) Enhanced Token Spam Lists =============================================================================================== ![Enhanced Token Spam Lists](https://www.datocms-assets.com/86369/1743204211-spam-token-list-expansion.jpg)With the release of the [Enhanced Spam Lists](https://goldrush.dev/docs/resources/enhanced-spam-lists) for ERC20 tokens and NFTs across all [Foundational Chains](https://goldrush.dev/chains/) , the following GoldRush APIs are now seamlessly updated to leverage these lists: * [Get token balances for address](https://goldrush.dev/docs/api-reference/balances/get-token-balances-for-address) using the `no-spam` query parameter. * [Get historical token balances for address](https://goldrush.dev/docs/api-reference/balances/get-historical-token-balances-for-address) using the `no-spam` query parameter. * [Get NFTs for address](https://goldrush.dev/docs/api-reference/nft/get-nfts-for-address) using the `no-spam` query parameter. In addition, any of the API responses with the `is_spam` field will incorporate the Enhanced Spam Lists.[Learn more](https://goldrush.dev/docs/resources/enhanced-spam-lists) [​](https://goldrush.dev/docs/changelog#february-20%2C-2025) February 20, 2025 Foundational API [​](https://goldrush.dev/docs/changelog#update-to-token-holders-api) Update to Token Holders API =================================================================================================== ![Update to Token Holders API](https://www.datocms-assets.com/86369/1741047446-token-holders-api-update-feb2025.jpg)The following changes were made to the [Token Holders API](https://goldrush.dev/docs/api-reference/balances/get-token-holders-as-of-any-block-height-v2) : * When no `block-height` is specified, the response is from the latest token holder snapshot that is updated every 30 minutes. This results in a fast response time. * To fetch the current token holders list without using the snapshot, set `no-snapshot=true`. This bypasses the cache and is dynamically calculated at request time. The snapshot exists for the top 100 tokens on each [Foundational Chain](https://goldrush.dev/chains/) as listed on [CoinGecko](https://www.coingecko.com/en/categories/ethereum-ecosystem) .This modification is to help address the two unique use cases for this API: 1. Displaying a list of token holders on leaderboards to provide guidance on a token’s distribution. This list does not generally need to be accurate to the minute. 2. Token holder lists for reward distributions and token gating. This is generally an accurate token list generated at a specific point in time. [Learn more](https://goldrush.dev/docs/api-reference/balances/get-token-holders-as-of-any-block-height-v2) [​](https://goldrush.dev/docs/changelog#february-20%2C-2025-2) February 20, 2025 Blockchain [​](https://goldrush.dev/docs/changelog#berachain-&-unichain-mainnets,-monad-testnet-indexed) Berachain & Unichain Mainnets, Monad Testnet Indexed ===================================================================================================================================================== ![Berachain & Unichain Mainnets, Monad Testnet Indexed](https://www.datocms-assets.com/86369/1741043738-blockchains-indexed-3_1_feb_2025.jpg)The following chains are now indexed and available via GoldRush: | Chain | Chain Name | Chain ID | | --- | --- | --- | | Berachain Mainnet | berachain-mainnet | 80094 | | Unichain Mainnet | unichain-mainnet | 130 | | Monad Testnet | monad-testnet | 10143 | [​](https://goldrush.dev/docs/changelog#february-1%2C-2025) February 1, 2025 General [​](https://goldrush.dev/docs/changelog#update-to-the-goldrush-professional-tier-and-pricing-change) Update to the GoldRush Professional Tier and Pricing Change =================================================================================================================================================================== There are some significant updates to our pricing structure, which were announced in late August, 2024, that are now in effect as of February 1, 2025. ### [​](https://goldrush.dev/docs/changelog#what-has-changed) What has Changed? **Our new Professional Tier has replaced the Premium Tier.** * Professional Tier: $250 per month for 300,000 API credits, with overages at 0.00077 per credit. * Existing Premium Tier users: You need to transition to the Professional Tier to ensure you continue to receive the same high-quality performance and features. If you prefer the existing Premium Tier pricing, you can sign up through [one of our channel partners](https://goldrush.dev/pricing/) where the Premium Tier is available at $50/month for 50,000 credits.**Our Free Tier has ended and replaced with the Free Trial.** * Existing grandfathered Free Tier users who signed up before the 14-day Free Trial was implemented will now need to upgrade to a paid tier effective February 1, 2025. ### [​](https://goldrush.dev/docs/changelog#why-the-changes) Why the Changes? We are making these updates to: * Ensure consistent pricing for our API across various marketplaces. * Provide better and more responsive support. * Maintain and enhance the quality of our services. For any questions or assistance, please contact us at [\[email protected\]](https://goldrush.dev/cdn-cgi/l/email-protection#bdcec8cdcdd2cfc9fdded2cbdcd1d8d3c9d5cc93ded2d0) .[Learn more](https://goldrush.dev/pricing/) [​](https://goldrush.dev/docs/changelog#january-29%2C-2025) January 29, 2025 Foundational API [​](https://goldrush.dev/docs/changelog#new-dex-pool-spot-prices-api) New DEX pool spot prices API ===================================================================================================== ![New DEX pool spot prices API](https://www.datocms-assets.com/86369/1743209907-dex-pool-spot-prices.jpg)Given the meme coin trading hype, GoldRush has released a new DEX pool spot prices API that supports pools on Uniswap V2, V3 and their forks on all [Foundational Chains](https://goldrush.dev/chains) .The API takes in the `contractAddress` of the pool and returns the following key fields: * `token_0_price` - Price of `token_0` in units of `token_1`. * `token_0_price_24` - Price of `token_0` in units of `token_1` as of 24 hours ago. * `token_0_price_quote` - Price of `token_0` in the selected quote currency (defaults to `USD`) * Similar values for `token_1_xx` making up the pool pair. This API leverages the onchain sync event to get the spot prices.[Learn more](https://goldrush.dev/docs/api-reference/utility/get-pool-spot-prices) [​](https://goldrush.dev/docs/changelog#december-12%2C-2024) December 12, 2024 Foundational API [​](https://goldrush.dev/docs/changelog#tracing-enhancements-supported-on-ethereum) Tracing Enhancements Supported on Ethereum ================================================================================================================================= ![Tracing Enhancements Supported on Ethereum](https://www.datocms-assets.com/86369/1741045831-tracing-enhancements-on-ethereum.jpg)Introducing the following tracing enhancements to our [Multichain & Multiaddress Transactions API](https://goldrush.dev/docs/api-reference/cross-chain/get-allchains-transactions) and [Get a Transaction](https://goldrush.dev/docs/api-reference/transactions/get-a-transaction) for `ethereum-mainnet`: * Internal Transactions * State Changes * Input Data Use the following query params: * `with-internal` - includes internal transfers/transactions in the chain’s native token. * `with-state` - includes all transaction state changes with before and after values * `with-input-data` - includes the transaction’s input data, currently just the Method ID. [Learn more](https://goldrush.dev/docs/api-reference/cross-chain/get-allchains-balances) [​](https://goldrush.dev/docs/changelog#december-10%2C-2024) December 10, 2024 Foundational API [​](https://goldrush.dev/docs/changelog#new-multichain-balances-api) New Multichain Balances API =================================================================================================== ![New Multichain Balances API](https://www.datocms-assets.com/86369/1741044671-multichain-balances_v2.jpg)Introducing the new GoldRush Multichain Balances API where you can fetch paginated spot & historical native and token balances for a single address on up to 10 EVM chains with one API call.Some key points to note: * The pagination method used for this API are **cursors** . Note the response includes the following cursor specific fields: * `cursor_before` - fetch token balances before a certain point in the response. * The values of these fields can be passed as query params to scroll through the token balances using `before={cursor_before}`. * If `cursor_before=null` , you have reached the first page of the token balances list. * ALL supported chains can be passed in the `chains=` query param (both chain names and ID’s are supported) up to a maximum of 10 chains. * When no chains are specified, the API defaults to use the [Foundational Chains](https://goldrush.dev/chains/) . * ERC20 token spam filtering is currently not supported but will be added. In the response, `is_spam` will always default to `false`. * When the `cutoff-timestamp` query param is passed, the balance snapshot will be from the nearest block _before_ the specified cutoff time. [Learn more](https://goldrush.dev/docs/api-reference/cross-chain/get-allchains-balances) [​](https://goldrush.dev/docs/changelog#november-18%2C-2024) November 18, 2024 General [​](https://goldrush.dev/docs/changelog#goldrush-changes-phase-1:-chain-classification-&-prioritization) GoldRush Changes Phase 1: Chain Classification & Prioritization =========================================================================================================================================================================== GoldRush is reorganizing its support for various chains by grouping them into four distinct categories:**Foundational Chains:** These are the top EVM-compatible chains that have achieved wide adoption. For these chains, GoldRush guarantees product parity across its entire suite of features. This includes tracing enhancements, historical token balances, token holders, and cached NFT assets. In addition, we’ll provide ecosystem support in the form of API credits, hackathon bounties, workshops, guides, and co-marketing activities.**Frontier Chains:** These chains, both EVM and non-EVM compatible, represent the cutting edge of blockchain innovation. While not all product features will be available for Frontier Chains, GoldRush will continue to offer its core APIs at an enterprise level, along with ecosystem support.**Community Chains:** These chains include those with passionate builder communities and will will offer core APIs including balances, transactions, and decoded log events.**Archived Chains:** No live data will be available for archived chains. Only historical data will continue to be provided for a brief period of time.[Learn more](https://goldrush.dev/chains/) [​](https://goldrush.dev/docs/changelog#november-18%2C-2024-2) November 18, 2024 Blockchain [​](https://goldrush.dev/docs/changelog#apechain,-world-chain-mainnets-&-unichain-testnet-indexed) ApeChain, World Chain Mainnets & Unichain Testnet Indexed =============================================================================================================================================================== ![ApeChain, World Chain Mainnets & Unichain Testnet Indexed](https://www.datocms-assets.com/86369/1732743861-apechain_unichain_worldchain.jpg)The following chains are now indexed and available via GoldRush: | Chain | Chain Name | Chain ID | | --- | --- | --- | | ApeChain Mainnet | apechain-mainnet | 33139 | | World Chain Mainnet | world-mainnet | 480 | | World Chain Testnet | world-sepolia-testnet | 4801 | | Unichain Testnet | unichain-sepolia-testnet | 1301 | [​](https://goldrush.dev/docs/changelog#october-18%2C-2024) October 18, 2024 Foundational API [​](https://goldrush.dev/docs/changelog#new-multichain-&-multiaddress-transactions-api) New Multichain & Multiaddress Transactions API ========================================================================================================================================= ![New Multichain & Multiaddress Transactions API](https://www.datocms-assets.com/86369/1732748430-multichain-multiaddress-transactions.jpg)Introducing the new GoldRush Multichain & Multiaddress Transactions API where you can fetch transactions for up to 10 EVM addresses across 10 EVM chains with one API call.Some key points to note: * The pagination method used for this API are **cursors** . Note the response includes the following cursor specific fields: * `cursor_before` * `cursor_after` The values of these fields can be passed as query params to scroll through the transactions using `before={cursor_before}` or `after={cursor_after}` * If `cursor_before=null` , you’ve reached the first page of the descending transaction list * Cursors are linked to the list of chains that transactions are fetched from. If, for example, you obtain a `cursor_before` value when querying `chains=1,56` and then try to use that value with `chains=1,137` , you will get an error. * ALL supported chains can be passed in the `chains=` query param (both chain names and ID’s are supported) up to a maximum of 10 chains. * When no chains are specified, the API defaults to use the [Foundational Chains](https://goldrush.dev/chains/) . [Learn more](https://goldrush.dev/docs/api-reference/cross-chain/get-allchains-transactions) [​](https://goldrush.dev/docs/changelog#october-16%2C-2024) October 16, 2024 Blockchain [​](https://goldrush.dev/docs/changelog#archiving-chains) Archiving Chains ============================================================================= ![Archiving Chains](https://www.datocms-assets.com/86369/1743208631-archived-chains.jpg)Support for several chains with little to no use will be limited to historical data and categorized as ‘Archived Chains’ effective immediately. No live data will be available for these chains.See the current list of Archived Chains [here](https://goldrush.dev/chains) .In general, GoldRush is reorganizing its prioritization and support for various chains with more on this to be announced soon.[Learn more](https://goldrush.dev/chains/) [​](https://goldrush.dev/docs/changelog#september-30%2C-2024) September 30, 2024 Blockchain [​](https://goldrush.dev/docs/changelog#cronos-zkevm,-sei,-fraxtal,-redstone-mainnets-and-berachain-testnet-indexed) Cronos zkEVM, Sei, Fraxtal, Redstone Mainnets and Berachain Testnet Indexed =================================================================================================================================================================================================== ![Cronos zkEVM, Sei, Fraxtal, Redstone Mainnets and Berachain Testnet Indexed](https://www.datocms-assets.com/86369/1732571637-cronos_sei_berachain_testnet.jpg)The following chains are now indexed and available via GoldRush: | Chain | Chain Name | Chain ID | | --- | --- | --- | | Berachain Testnet | berachain-testnet | 80084 | | Sei Mainnet | sei-mainnet | 1329 | | Fraxtal Mainnet | fraxtal-mainnet | 252 | | Redstone Mainnet | redstone-mainnet | 690 | | Cronos zkEVM Mainnet | cronos-zkevm-mainnet | 388 | [​](https://goldrush.dev/docs/changelog#september-20%2C-2024) September 20, 2024 General [​](https://goldrush.dev/docs/changelog#introducing-the-customizable-block-explorer-template) Introducing the Customizable Block Explorer Template ===================================================================================================================================================== ![Introducing the Customizable Block Explorer Template](https://www.datocms-assets.com/86369/1732742509-goldrush-block-explorer-template.jpg)Leveraging the GoldRush UI Kit, the customizable [GoldRush Block Explorer template](https://goldrush-block-explorer.vercel.app/) works seamlessly across all supported chains and is designed to make onchain verification and exploration easier than ever.Some of the key features are: * Real-time Block Explorer: Provides up-to-date information on blockchain transactions, blocks, and account balances in real time, giving users the latest data. * Ready-to-use customizable template: Jumpstart your dApp journey with a beautifully designed UI that’s both intuitive and engaging. * Cross Chain Support: Supports 100+ chains, providing a unified explorer for all your needs. * Comprehensive Data Filtering: Search and filter through blockchain data with options to refine by transaction type, block height, or account, making it ideal for both casual users and developers. * UI Template: The GoldRush Block Explorer can be customized with different colors and modes per deployment. [Learn more](https://github.com/covalenthq/goldrush-block-explorer-ui) [​](https://goldrush.dev/docs/changelog#september-1%2C-2024) September 1, 2024 General [​](https://goldrush.dev/docs/changelog#introducing-the-goldrush-professional-tier-and-pricing-change) Introducing the GoldRush Professional Tier and Pricing Change ======================================================================================================================================================================= There are some significant updates to our pricing structure, effective September 1, 2024. ### [​](https://goldrush.dev/docs/changelog#what%E2%80%99s-changing) What’s Changing? **Our new Professional Tier will replace the Premium Tier.** * Professional Tier: $250 per month for 300,000 API credits, with overages at 0.00077 per credit. * Existing Premium Tier users: You can continue with your current plan until February 1, 2025. You will then need to transition to the Professional Tier to ensure you continue to receive the same high-quality performance and features. If you prefer the existing Premium Tier pricing, you can sign up through [one of our channel partners](https://goldrush.dev/pricing/) where the Premium Tier is available at $50/month for 50,000 credits. ### [​](https://goldrush.dev/docs/changelog#why-the-changes-2) Why the Changes? We are making these updates to: * Ensure consistent pricing for our API across various marketplaces. * Provide better and more responsive support. * Maintain and enhance the quality of our services. ### [​](https://goldrush.dev/docs/changelog#what%E2%80%99s-next) What’s Next? The new Professional Tier will offer the same performance and features you’ve come to expect from our Premium Tier. We’ll provide more details soon, and we’re here to support you during this transition. For any questions or assistance, please contact us at [\[email protected\]](https://goldrush.dev/cdn-cgi/l/email-protection#45363035352a373105262a332429202b312d346b262a28) .[Learn more](https://goldrush.dev/pricing/) [​](https://goldrush.dev/docs/changelog#july-31%2C-2024) July 31, 2024 API [​](https://goldrush.dev/docs/changelog#new-non-breaking-import-statement-for-goldrush-sdks) New (Non-Breaking) Import Statement for GoldRush SDKs ===================================================================================================================================================== ![New (Non-Breaking) Import Statement for GoldRush SDKs](https://www.datocms-assets.com/86369/1722467559-goldrush-sdk.jpg)Following the rebrand of Covalent’s data products to “GoldRush”, the following import statement is now supported through the SDKs: `import { GoldRushClient } from "@covalenthq/client-sdk";`This is a non-breaking change, so projects using `import { CovalentClient } from "@covalenthq/client-sdk";` will be unaffected.[Learn more](https://goldrush.dev/docs/unified-api/quickstart/typescript-sdk/) [Frequently Asked Questions](https://goldrush.dev/docs/faq) [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks) ⌘I --- # Overview - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/overview#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation GoldRush Streaming API Overview [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Use Cases](https://goldrush.dev/docs/goldrush-streaming-api/overview#use-cases) * [Available Streams](https://goldrush.dev/docs/goldrush-streaming-api/overview#available-streams) * [Supported Chains & DEXes](https://goldrush.dev/docs/goldrush-streaming-api/overview#supported-chains-%26-dexes) [​](https://goldrush.dev/docs/goldrush-streaming-api/overview#use-cases) Use Cases ------------------------------------------------------------------------------------- ![1748642802-streaming-api-products-ohlcv](https://www.datocms-assets.com/86369/1748642802-streaming-api-products-ohlcv.png) Trading Bots ------------ Power your bots with new pairs, pair liquidity changes, OHLCV pricing data, and wallet activity to copy trade. ![1748642719-streaming-api-products-gamefi](https://www.datocms-assets.com/86369/1748642719-streaming-api-products-gamefi.png) Gaming ------ Stream inventory balances and onchain game state right into your game engine with no lag or polling. ![1748642703-streaming-api-products-ai](https://www.datocms-assets.com/86369/1748642703-streaming-api-products-ai.png) AI Agents --------- Power your AI Agents with streaming wallet information to build novel co-pilot apps. [​](https://goldrush.dev/docs/goldrush-streaming-api/overview#available-streams) Available Streams ----------------------------------------------------------------------------------------------------- The GoldRush Streaming API offers the following streams: * [**OHLCV Tokens Stream**](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) : Continuous price data feed providing Open, High, Low, Close, Volume values for one or many tokens at configurable intervals. Commonly used to execute trading strategies like take-profit, stop-loss and others. * [**OHLCV Pairs Stream**](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) : Continuous price data feed providing Open, High, Low, Close, Volume values for one or many token pairs at configurable intervals. Commonly used to execute trading strategies like take-profit, stop-loss and others. * [**New DEX Pairs Stream**](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) : Real-time updates on new pairs, pair liquidity changes, and other pair-related events across supported DEXes. Commonly used to build liquidity sniping bots. * [**Update Pairs Stream**](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs) : Real-time price, liquidity, volume, and market cap updates for tracked token pairs. Commonly used to monitor portfolio exposure or trigger alerting workflows. * [**Wallet Activity Stream**](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) : Live tracking of wallet transactions, token transfers, and interactions with smart contracts. Commonly used to build copy trading bots. [​](https://goldrush.dev/docs/goldrush-streaming-api/overview#supported-chains-&-dexes) Supported Chains & DEXes ------------------------------------------------------------------------------------------------------------------- | Chain | Supported DEXes | | --- | --- | | `BASE_MAINNET` | * `VIRTUALS_V2`
* `CLANKER`
* `UNISWAP_V2`
* `UNISWAP_V3` | | `SOLANA_MAINNET` | * `RAYDIUM_AMM`
* `RAYDIUM_CPMM`
* `PUMP_FUN`
* `PUMP_FUN_AMM`
* `MOONSHOT`
* `RAYDIUM_LAUNCH_LAB`
* `METEORA_DAMM`
* `METEORA_DLMM`
* `METEORA_DBC` | | `ETH_MAINNET` | * `UNISWAP_V2`
* `UNISWAP_V3` | | `BSC_MAINNET` | * `PANCAKESWAP_V2`
* `PANCAKESWAP_V3` | | `SONIC_MAINNET` | * `SHADOW_V2`
* `SHADOW_V3` | | `MONAD_MAINNET` | * `OCTOSWAP_V2`
* `OCTOSWAP_V3` | [Quickstart](https://goldrush.dev/docs/goldrush-streaming-api/quickstart) ⌘I --- # Supported Chains - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/overview#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Overview Supported Chains [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/overview#overview) * [Chain Categories](https://goldrush.dev/docs/chains/overview#chain-categories) * [Foundational Chains](https://goldrush.dev/docs/chains/overview#foundational-chains) * [Frontier Chains](https://goldrush.dev/docs/chains/overview#frontier-chains) * [Community Chains](https://goldrush.dev/docs/chains/overview#community-chains) * [Archived Chains](https://goldrush.dev/docs/chains/overview#archived-chains) * [Quick Start](https://goldrush.dev/docs/chains/overview#quick-start) * [Additional Resources](https://goldrush.dev/docs/chains/overview#additional-resources) [Live Chain Status\ -----------------\ \ View real-time status of all supported chains.](https://goldrush.dev/chains/) [​](https://goldrush.dev/docs/chains/overview#overview) Overview ------------------------------------------------------------------- GoldRush offers support for **50** blockchain networks with the most comprehensive Blockchain 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 Blockchain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. [​](https://goldrush.dev/docs/chains/overview#chain-categories) Chain Categories ----------------------------------------------------------------------------------- ### [​](https://goldrush.dev/docs/chains/overview#foundational-chains) Foundational Chains These are the top EVM-compatible chains with guaranteed product parity across the entire GoldRush feature suite, including tracing enhancements. [![Ethereum Logo](https://www.datocms-assets.com/86369/1669653891-eth.svg)Ethereum\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/ethereum) [![Polygon Logo](https://www.datocms-assets.com/86369/1677870347-property-1-polygon-zkevm-icon-white.svg)Polygon\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/polygon) [![BNB Smart Chain (BSC) Logo](https://www.datocms-assets.com/86369/1670003808-binance-smart-chain-icon-white.svg)BNB Smart Chain (BSC)\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc) [![Optimism Logo](https://www.datocms-assets.com/86369/1670347457-optimism-icon-white.svg)Optimism\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/optimism) [![Base Logo](https://www.datocms-assets.com/86369/1756321884-base-icon-white.svg)Base\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/base) [![Gnosis Logo](https://www.datocms-assets.com/86369/1695328167-gnosis-chain-icon-white.svg)Gnosis\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/gnosis) ### [​](https://goldrush.dev/docs/chains/overview#frontier-chains) Frontier Chains Cutting-edge blockchain networks where GoldRush continues to expand feature coverage as the ecosystem evolves. [![Bitcoin Logo](https://www.datocms-assets.com/86369/1674516372-property-1-bitcoin-icon-white.svg)Bitcoin\ \ Mainnet](https://goldrush.dev/docs/chains/bitcoin) [![Avalanche C-Chain Logo](https://www.datocms-assets.com/86369/1686152918-avalanche-icon-white.svg)Avalanche C-Chain\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/avalanche-c-chain) [![ADI Chain Logo](https://www.datocms-assets.com/86369/1762381992-adi-icon-white.svg)ADI Chain\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/adi-chain) [![ApeChain Logo](https://www.datocms-assets.com/86369/1721237126-apechain-icon-white.svg)ApeChain\ \ Mainnet](https://goldrush.dev/docs/chains/apechain) [![Arbitrum Logo](https://www.datocms-assets.com/86369/1686072650-arbitrum-icon-white.svg)Arbitrum\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/arbitrum) [![Arbitrum Nova Logo](https://www.datocms-assets.com/86369/1675883705-property-1-nova-icon-white.svg)Arbitrum Nova\ \ Mainnet](https://goldrush.dev/docs/chains/arbitrum-nova) [![Arc Logo](https://www.datocms-assets.com/86369/1761667158-arc-icon-white.svg)Arc\ \ Testnet](https://goldrush.dev/docs/chains/arc) [![Axie/Ronin Logo](https://www.datocms-assets.com/86369/1669931671-axie.svg)Axie/Ronin\ \ Mainnet](https://goldrush.dev/docs/chains/axie-ronin) [![Berachain Logo](https://www.datocms-assets.com/86369/1721060184-berachain-icon-white.svg)Berachain\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/berachain) [![HyperCore Logo](https://www.datocms-assets.com/86369/1754500110-hyperevm-icon-white.svg)HyperCore\ \ Mainnet](https://goldrush.dev/docs/chains/hypercore) [![HyperEVM Logo](https://www.datocms-assets.com/86369/1754500110-hyperevm-icon-white.svg)HyperEVM\ \ Mainnet](https://goldrush.dev/docs/chains/hyperevm) [![Ink Logo](https://www.datocms-assets.com/86369/1732899594-ink-icon-white.svg)Ink\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/ink) [![Lens Logo](https://www.datocms-assets.com/86369/1732061231-lens-icon-white.svg)Lens\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/lens) [![Linea Logo](https://www.datocms-assets.com/86369/1679953835-property-1-linea-icon-white.svg)Linea\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/linea) [![Mantle Logo](https://www.datocms-assets.com/86369/1677538585-property-1-mantle-icon-white.svg)Mantle\ \ Mainnet](https://goldrush.dev/docs/chains/mantle) [![Monad Logo](https://www.datocms-assets.com/86369/1739233630-monad-icon-white.svg)Monad\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/monad) [![Oasis Sapphire Logo](https://www.datocms-assets.com/86369/1669933877-oasis.svg)Oasis Sapphire\ \ Mainnet](https://goldrush.dev/docs/chains/oasis-sapphire) [![Plasma Logo](https://www.datocms-assets.com/86369/1761690226-plasma-icon-white.svg)Plasma\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/plasma) [![Scroll Logo](https://www.datocms-assets.com/86369/1697057853-scroll-icon-white.svg)Scroll\ \ Mainnet](https://goldrush.dev/docs/chains/scroll) [![Sei Logo](https://www.datocms-assets.com/86369/1719366713-sei-icon-white.svg)Sei\ \ Mainnet](https://goldrush.dev/docs/chains/sei) [![Solana Logo](https://www.datocms-assets.com/86369/1670614895-solana-icon-white.svg)Solana\ \ Mainnet](https://goldrush.dev/docs/chains/solana) [![Sonic Logo](https://www.datocms-assets.com/86369/1754945861-sonic-icon-white.svg)Sonic\ \ Mainnet](https://goldrush.dev/docs/chains/sonic) [![Taiko Logo](https://www.datocms-assets.com/86369/1695749616-taiko-icon-white.svg)Taiko\ \ Mainnet](https://goldrush.dev/docs/chains/taiko) [![Unichain Logo](https://www.datocms-assets.com/86369/1729276538-unichain-icon-white.svg)Unichain\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/unichain) [![Viction Logo](https://www.datocms-assets.com/86369/1698867827-viction-icon-white.svg)Viction\ \ Mainnet](https://goldrush.dev/docs/chains/viction) [![World Chain Logo](https://www.datocms-assets.com/86369/1731090239-world-icon-white.svg)World Chain\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/world-chain) [![zkSync Era Logo](https://www.datocms-assets.com/86369/1691631490-zksync-era-icon-white.svg)zkSync Era\ \ Mainnet](https://goldrush.dev/docs/chains/zksync-era) ### [​](https://goldrush.dev/docs/chains/overview#community-chains) Community Chains Community-driven blockchain networks with growing GoldRush integration and feature support. [![Fantom Logo](https://www.datocms-assets.com/86369/1669925386-fantom.svg)Fantom\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/fantom) [![Blast Logo](https://www.datocms-assets.com/86369/1710534544-blast-icon-white.svg)Blast\ \ Mainnet](https://goldrush.dev/docs/chains/blast) [![opBNB Logo](https://www.datocms-assets.com/86369/1692813949-opbnb-icon-white.svg)opBNB\ \ Mainnet](https://goldrush.dev/docs/chains/opbnb) [![Canto Logo](https://www.datocms-assets.com/86369/1675984804-property-1-canto-icon-white.svg)Canto\ \ Mainnet](https://goldrush.dev/docs/chains/canto) [![Celo Logo](https://www.datocms-assets.com/86369/1705948628-celo-icon-white.svg)Celo\ \ Mainnet](https://goldrush.dev/docs/chains/celo) [![Covalent Logo](https://www.datocms-assets.com/86369/1670020705-covalent-icon-white.svg)Covalent\ \ Mainnet](https://goldrush.dev/docs/chains/covalent) [![Cronos zkEVM Logo](https://www.datocms-assets.com/86369/1710187386-cronos-zkevm-icon-white.svg)Cronos zkEVM\ \ Mainnet](https://goldrush.dev/docs/chains/cronos-zkevm) [![Oasis Logo](https://www.datocms-assets.com/86369/1669933877-oasis.svg)Oasis\ \ Mainnet](https://goldrush.dev/docs/chains/oasis) [![Manta Pacific Logo](https://www.datocms-assets.com/86369/1694716333-manta-pacific-icon-white.svg)Manta Pacific\ \ Testnet](https://goldrush.dev/docs/chains/manta-pacific) [![Moonbeam Logo](https://www.datocms-assets.com/86369/1669924204-moonbeam.svg)Moonbeam\ \ Mainnet](https://goldrush.dev/docs/chains/moonbeam) [![Moonriver Logo](https://www.datocms-assets.com/86369/1669924101-moonriver.svg)Moonriver\ \ Mainnet](https://goldrush.dev/docs/chains/moonriver) [![Redstone Logo](https://www.datocms-assets.com/86369/1721059591-redstone-icon-white.svg)Redstone\ \ Mainnet](https://goldrush.dev/docs/chains/redstone) [![ZetaChain Logo](https://www.datocms-assets.com/86369/1693503842-zetachain-icon-white.svg)ZetaChain\ \ Mainnet](https://goldrush.dev/docs/chains/zetachain) ### [​](https://goldrush.dev/docs/chains/overview#archived-chains) Archived Chains Previously supported blockchain networks that are now in archived status with limited data availability. [![Cronos Logo](https://www.datocms-assets.com/86369/1669933123-cronos.svg)Cronos\ \ Mainnet](https://goldrush.dev/docs/chains/cronos) [![Harmony Logo](https://www.datocms-assets.com/86369/1669932573-harmony.svg)Harmony\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/harmony) [![Lisk Logo](https://www.datocms-assets.com/86369/1714688744-lisk-icon-white.svg)Lisk\ \ Mainnet & Testnet](https://goldrush.dev/docs/chains/lisk) [![Loot Chain Logo](https://www.datocms-assets.com/86369/1692727278-loot-icon-white.svg)Loot Chain\ \ Mainnet](https://goldrush.dev/docs/chains/loot-chain) [​](https://goldrush.dev/docs/chains/overview#quick-start) Quick Start ------------------------------------------------------------------------- To get started with any supported chain, you can use either the chain name or chain ID in your API calls: cURL TypeScript SDK Python SDK Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/{chainName}/address/{address}/balances_v2/?key=API_KEY" [​](https://goldrush.dev/docs/chains/overview#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [API Reference](https://goldrush.dev/docs/api-reference) * [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks) [Ethereum](https://goldrush.dev/docs/chains/ethereum) ⌘I --- # Quickstart - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation GoldRush Foundational API Quickstart [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Introduction](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#introduction) * [Prerequisites](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#prerequisites) * [Supported Chains](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#supported-chains) * [Using the GoldRush TypeScript SDK](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#using-the-goldrush-typescript-sdk) * [Step 1. Install the SDK](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-1-install-the-sdk) * [Step 2. Import the Client](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-2-import-the-client) * [Step 3. Initialize the Client](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-3-initialize-the-client) * [Step 4. Invoke the Service](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-4-invoke-the-service) [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#introduction) Introduction ------------------------------------------------------------------------------------------------ This quickstart guide walks through using the [GoldRush TypeScript SDK](https://goldrush.dev/docs/goldrush-foundational-api/goldrush-sdks) to quickly build with multichain data leveraging the powerful GoldRush APIs. [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#prerequisites) Prerequisites -------------------------------------------------------------------------------------------------- Using any of the GoldRush developer tools requires an API key.[Get Started\ -----------\ \ Sign up for a free API key to get started with GoldRush.](https://goldrush.dev/platform/auth/register/) [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#supported-chains) Supported Chains -------------------------------------------------------------------------------------------------------- GoldRush can be used with any of the supported chains. See the full list, including chain categorization, at [Supported Chains](https://goldrush.dev/chains/) . Some data enrichments such as internal transactions and historical balance fetches are only available for Foundational Chains. [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#using-the-goldrush-typescript-sdk) Using the GoldRush TypeScript SDK ------------------------------------------------------------------------------------------------------------------------------------------ The GoldRush TypeScript SDK is the fastest way to integrate the GoldRush APIs for working with blockchain data. The SDK works with all supported chains including Mainnets and Testnets. This SDK requires NodeJS v18 or above. ### [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-1-install-the-sdk) Step 1. Install the SDK npm yarn Copy Ask AI npm install @covalenthq/client-sdk See the package on [npmjs](https://www.npmjs.com/package/@covalenthq/client-sdk) for more details. ### [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-2-import-the-client) Step 2. Import the Client The `GoldRushClient` class provides typesafe, easy-to-use helper functions and classes to use the GoldRush APIs. Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; ### [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-3-initialize-the-client) Step 3. Initialize the Client Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); }; ### [​](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#step-4-invoke-the-service) Step 4. Invoke the Service In this quickstart, we use the `BalanceService` and `getTokenBalancesForWalletAddress()` function to fetch all token balances held by an address. This function takes a chain name and wallet address as required arguments. ENS resolution is supported for `eth-mainnet`. Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { // Replace with your GoldRush API key const client = new GoldRushClient("YOUR_API_KEY"); const response = await client.BalanceService.getTokenBalancesForWalletAddress("eth-mainnet", "demo.eth"); if (!response.error) { console.log(response.data); } else { console.log(response.error_message); } }; ApiServices(); Example response: Copy Ask AI { "address": "0xfc43f5f9dd45258b3aff31bdbe6561d97e8b71de", "chain_id": 1, "chain_name": "eth-mainnet", "quote_currency": "USD", "updated_at": "2024-11-05T22:18:41.522Z", "items": [\ {\ "contract_decimals": 6,\ "contract_name": "Tether USD",\ "contract_ticker_symbol": "USDT",\ "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\ "contract_display_name": "Tether USD",\ "supports_erc": [],\ "logo_url": "https://logos.covalenthq.com/tokens/1/0xdac17f958d2ee523a2206206994597c13d831ec7.png",\ "last_transferred_at": "2024-08-28T12:43:35.000Z",\ "native_token": false,\ "type": "stablecoin",\ "is_spam": false,\ "balance": "3007173042",\ "balance_24h": "3007173042",\ "quote_rate": 1,\ "quote_rate_24h": 0.9992,\ "quote": 3007.173,\ "quote_24h": 3004.7673,\ "pretty_quote": "$3,007.17",\ "pretty_quote_24h": "$3,004.77",\ "logo_urls": {},\ "protocol_metadata": null,\ "nft_data": null\ }\ ] } [Overview](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Authentication](https://goldrush.dev/docs/goldrush-foundational-api/authentication) ⌘I --- # Authentication - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-foundational-api/authentication#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation GoldRush Foundational API Authentication [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Why is Authentication Required?](https://goldrush.dev/docs/goldrush-foundational-api/authentication#why-is-authentication-required) * [1\. Obtaining a GoldRush API Key](https://goldrush.dev/docs/goldrush-foundational-api/authentication#1-obtaining-a-goldrush-api-key) * [2\. Supplying the API Key](https://goldrush.dev/docs/goldrush-foundational-api/authentication#2-supplying-the-api-key) * [Using SDKs (Recommended)](https://goldrush.dev/docs/goldrush-foundational-api/authentication#using-sdks-recommended) * [Direct API Calls](https://goldrush.dev/docs/goldrush-foundational-api/authentication#direct-api-calls) * [Error Handling](https://goldrush.dev/docs/goldrush-foundational-api/authentication#error-handling) * [Frequently Asked Questions (FAQ)](https://goldrush.dev/docs/goldrush-foundational-api/authentication#frequently-asked-questions-faq) This document provides a comprehensive overview of the authentication process for the Foundational API. All APIs are protected and require a valid GoldRush API key to access. This guide covers how to obtain and use an API key, with examples for both our SDKs and direct REST API calls. [​](https://goldrush.dev/docs/goldrush-foundational-api/authentication#why-is-authentication-required) Why is Authentication Required? ----------------------------------------------------------------------------------------------------------------------------------------- Authentication is essential to ensure that only authorized users can access the Foundational API. It allows us to manage access, track usage for billing, and ensure the security and stability of our services. [​](https://goldrush.dev/docs/goldrush-foundational-api/authentication#1-obtaining-a-goldrush-api-key) 1\. Obtaining a GoldRush API Key ------------------------------------------------------------------------------------------------------------------------------------------ To begin, register for an API key at the [GoldRush Platform](https://goldrush.dev/platform/auth/register/) . This key will be required for all requests to the Foundational API. [​](https://goldrush.dev/docs/goldrush-foundational-api/authentication#2-supplying-the-api-key) 2\. Supplying the API Key ---------------------------------------------------------------------------------------------------------------------------- The Foundational API offers flexible and powerful ways to access blockchain data. You can use one of our GoldRush SDKs for a streamlined experience, or make direct HTTP requests to the various REST APIs. ### [​](https://goldrush.dev/docs/goldrush-foundational-api/authentication#using-sdks-recommended) Using SDKs (Recommended) For easier integration and to take advantage of built-in features like automatic retries and rate limit handling, we recommend using the TypeScript Client SDK. * TypeScript Initialize the client with your API key: Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY_HERE"); // Replace with your GoldRush API key const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "eth-mainnet", walletAddress: "vitalik.eth" }); if (!resp.error) { console.log(resp.data); } else { console.log(resp.error_message); } }; ApiServices(); ### [​](https://goldrush.dev/docs/goldrush-foundational-api/authentication#direct-api-calls) Direct API Calls You can also authenticate by including your API key in direct HTTP requests. Basic Authentication Provide your API key as the Basic Auth username. You do not need to provide a password. The trailing colon (`:`) prevents `curl` from prompting for a password. Copy Ask AI curl -X GET https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/ \ -u YOUR_API_KEY_HERE: \ -H 'Content-Type: application/json' Bearer Token Provide your API key in an `Authorization` header with the `Bearer` scheme. Copy Ask AI curl -X GET https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/ \ -H 'Authorization: Bearer YOUR_API_KEY_HERE' Query Parameter Include your API key as the `key` query parameter in the request URL. Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/demo.eth/balances_v2/?key=YOUR_API_KEY_HERE" [​](https://goldrush.dev/docs/goldrush-foundational-api/authentication#error-handling) Error Handling -------------------------------------------------------------------------------------------------------- If an authentication-related error occurs, the API will return a `4XX` HTTP status code and a JSON body with details. | Code | Description | | --- | --- | | `401 - Unauthorized` | No valid API key was provided, or the key is incorrect. | | `402 - Payment Required` | The account has consumed its allocated API credits. | | `429 - Too Many Requests` | You are being rate-limited. | [​](https://goldrush.dev/docs/goldrush-foundational-api/authentication#frequently-asked-questions-faq) Frequently Asked Questions (FAQ) ------------------------------------------------------------------------------------------------------------------------------------------ * **Which authentication method should I use?** * We strongly recommend using our [SDKs](https://goldrush.dev/docs/goldrush-foundational-api/authentication#using-sdks-recommended) for the best developer experience. If you must make direct API calls, **Basic Authentication** is preferred over other methods for its security. Placing API keys in URLs (query parameter) is generally discouraged. * **Where can I find my API Key?** * You can find your API key on the [GoldRush Platform](https://goldrush.dev/platform/auth/register/) after signing up or logging in. * **Are the API keys the same for the different GoldRush products?** * Yes, the same API key is used to authenticate with all GoldRush products. [Quickstart](https://goldrush.dev/docs/goldrush-foundational-api/quickstart) [Get activity across all chains for address](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity) ⌘I --- # Enhanced Bitcoin Support - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/resources/enhanced-bitcoin-support#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Resources Enhanced Bitcoin Support [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Key Concepts](https://goldrush.dev/docs/resources/enhanced-bitcoin-support#key-concepts) * [Capabilities](https://goldrush.dev/docs/resources/enhanced-bitcoin-support#capabilities) * [API endpoints](https://goldrush.dev/docs/resources/enhanced-bitcoin-support#api-endpoints) GoldRush offers production-grade Bitcoin data for wallets, tax tools, explorers, and analytics. We operate dedicated Bitcoin node infrastructure and index the chain from the genesis block to ensure complete, accurate balance and transaction history. ### [​](https://goldrush.dev/docs/resources/enhanced-bitcoin-support#key-concepts) Key Concepts * **Hierarchical Deterministic (HD) Wallet** refers to a wallet that generates all of its keys and addresses from a single source (e.g. a seed phrase). These keys and addresses can be organized into a tree (hierarchial) and are always generated the same way (deterministic). * **Extended public keys** (e.g., `xpub...`, `ypub...`, `zpub...`) are HD address-level public keys used to derive many child receive addresses. * **Non-HD addresses or child addresses** follow different standards: * **BIP44 Legacy, P2PKH**: addresses typically start with `1`, derived path `m/44'/0'/...` * **BIP49 Nested SegWit, P2SH-P2WPKH**: addresses typically start with `3`, derived path `m/49'/0'/...` * **BIP84 Native SegWit, P2WPKH/bech32**: addresses typically start with `bc1`, derived path `m/84'/0'/...` * **BIP86 Taproot, P2TR**: addresses typically start with `bc1p`, derived path `m/86'/0'/...` For an excellent resource to understand HD wallets and derivation paths, see: [Learn Me A Bitcoin - HD Wallets](https://learnmeabitcoin.com/technical/keys/hd-wallets/) ### [​](https://goldrush.dev/docs/resources/enhanced-bitcoin-support#capabilities) Capabilities * **Full-chain ingestion**: Dedicated node and indexers ingest all Bitcoin transactions from genesis for complete historical coverage. * **Extensive HD wallet derivation scans (gap limit 20)**: We continue to derive child addresses until encountering 20 consecutive child addresses with zero balance and no transaction history. * **Support multiple child address formats**: Includes BIP44 Legacy, BIP49 Nested SegWit, BIP84 Native SegWit. * **Spot and historical balances for non-HD/child addresses**: Includes current and historical **fiat price** conversions. * **Spot balances for derived child addresses from HD wallet addresses (xpub/ypub/zpub)**: Includes spot balances, fiat prices and 24hr deltas. * **Historical transactions for non-HD addresses**: Retrieve time-ordered transactions for a Bitcoin address for statements, tax, and activity feed workflows. ### [​](https://goldrush.dev/docs/resources/enhanced-bitcoin-support#api-endpoints) API endpoints * [Get Bitcoin balances for HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address) * [Get Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address) * [Get historical Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address) * [Get transactions for Bitcoin non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address) [Get resolved address for registered address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address) [NFT Supported Formats](https://goldrush.dev/docs/resources/nft-supported-formats) ⌘I --- # NFT Supported Formats - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/resources/nft-supported-formats#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Resources NFT Supported Formats [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Decoding base64 thumbhash](https://goldrush.dev/docs/resources/nft-supported-formats#decoding-base64-thumbhash) The GoldRush API supports the following NFT formats: **Images:** * `image/png` * `image/jpeg` * `image/gif` * `image/svg+xml` * `image/webp` * `image/bmp` * `image/tiff` * `image/vnd.adobe.photoshop` * `image/avif` * `image/heic` * `image/jp2` * `image/heif` * `image/x-canon-cr2` **Videos:** Images are rendered as thumbnails of the first frame of the video. * `video/mp4` * `video/quicktime` * `video/x-m4v` * `video/3gpp` * `video/webm` * `video/x-matroska` * `video/x-ms-wmv` * `video/mpeg` * `video/x-flv` * `video/x-msvideo` **Audio:** Images are rendered as thumbnails of an audio waveform. * `audio/mp4` * `audio/mpeg` * `audio/vnd.wave` * `audio/vorbis` * `audio/x-flac` * `audio/x-m4a` * `audio/x-wav` [​](https://goldrush.dev/docs/resources/nft-supported-formats#decoding-base64-thumbhash) Decoding base64 thumbhash --------------------------------------------------------------------------------------------------------------------- Developers can use the [thumbhash npm package](https://www.npmjs.com/package/thumbhash) to decode the hash into a data url: Copy Ask AI ThumbHash.thumbHashToDataURL(new Uint8Array(atob("ewgGDwLG3DVomId/dkSKhmlsubILoKgC").split('').map(x => x.charCodeAt(0)))) This results in a data url(copy paste in chrome to see the blurred version of the asset image created using thumbhash): Copy Ask AI data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAQxklEQVR4AQCBAH7/AP////////////////////////////////////////r/+v/w//L55//t9eL/7fXi//P65//7/+/////4///////////////////////////////////////////////////////////////////////////////////+/////P//AIEAfv8A////////////////////////////////////////9v/2/ev/7vXi/+nx3f/p8d3/7/bi//f+6/////T////9//////////////////////////3////8/////f////////////////////////////////////////z////5//8AgQB+/wD///r////9//////////////////////////n/+f/v/+/25P/n7dr/4unV/+Lp1f/o79v/8ffj//r/7f////b////8/////v////3////6////9//8/Pb//Pv3//78+////v////////////////////7////6////9////fT//wCBAH7/AP3/9f////f////6/////f////z////4//v/8P/x9+X/5+3a/97k0f/Z4Mv/2uDM/+Dm0f/p79r/8/jk//z/7v////T////2////9f/9/vL/+fnv//b17v/18+//+PTz//v3+P//+v3///v////7////+f///vX///rx/f/47/z/AIEAfv8A+v3w//z/8v////T////2////9f/8//D/9Pnn/+nu3P/e49D/1dvH/9HWwf/S18L/2N3I/+Lm0f/t8dz/9vrm//z/7P/+/+///P3u//j46//z8uj/8O7n//Dt6P/y7uz/9vHx//r09//99vv//vb9//30/f/68fv/9+34//br9/8AgQB+/wD4++3/+v3v//3/8f/+//L//f/w//f76v/v8uD/4+fU/9jcyP/P077/y8+5/8zQuv/T18D/3eHL/+js1v/y9eD/+fvn//v86v/5+en/9fTm//Hv4//u6uL/7enj//Dq5//07ez/+PDy//vz9//98/n//PL5//rv+P/37Pb/9ur1/wCBAH7/APr77P/7/e7//f/v//7/7//7/ez/9fjm/+zu2//g4s//1NfC/8vOuP/HyrT/ycy1/9DTvP/b3sf/6OnT//Lz3v/5+uX//Pvp//r56P/29OX/8e7i/+7q4P/u6OH/8Onk//Ts6v/58PD//fL1///z+P/+8vn//fD4//vu9//57PX/AIEAfv8A/f7u////7/////D////v//3+7P/29+T/6+3Z/9/hzP/T1b//ysy1/8fIsf/Jy7P/0dO7/93ex//q69T/9vXf//385////ur//vvq//r25v/18OP/8uzh//Hq4v/z6+X/+O7r//3y8f//9ff///b6///2/P//9Pv///L6///x+f8AgQB+/wD///L////y////8/////H////t//j45f/t7dn/4eHL/9XVvv/MzLX/ycmx/8zMtP/V1bz/4uHJ/+/v1v/7+uP////r////7v///+7///vq//v15v/38OT/9u3k//ju6P/98e3///b0///5+v//+/7///v////6////+f////f//wCBAH7/AP//9f////b////2////9P///+//+/rm//Dv2v/j4sz/19a//8/Otv/My7L/0M+2/9rYv//n5sz/9vTb////5/////D////z////8v///+7///nq//305//88ef//vLq///18P//+ff///39/////////////////////////v//AIEAfv8A///4////+P////j////2////8P/+/Of/8vDa/+XjzP/Z17//0c+3/8/NtP/U0bf/3tzB/+zpz//7+N7////r////9P////f////2////8v///ez///fp///06P//9Ov///fx///7+P////7///////////////////////////8AgQB+/wD///n////5////+f////b////w///85v/z8Nr/5uPM/9rXv//S0Lb/0c60/9bTuP/h3cL/8OzR///64P///+3////2////+f////f////y///97P//9uj///Pn///z6f//9e7///r1///+/P///////////////////////////wCBAH7/AP//+P////j////3////9P///+7//vrk//Lu1//l4cn/2dW9/9LOtP/QzLL/1tG3/+Hdwf/w69D///rf////7P////X////3////9f///+////ro///y4//87uH//e3j///w6P//9e////n2///9/P//////////////////////AIEAfv8A///1////9f////T////x////6v/69uH/7urU/+Hdxv/W0rn/z8qx/83Jrv/TzrP/3tm+/+3ozf/999z////o////8P////L////v///86P//8+H/+Ovb//Xm2P/15dr/+eff///r5v//8e3///Xz///3+P//+fr///n7///5+/8AgQB+/wD///D////w////7////+z///rm//bx3P/q5c//3djB/9HNtP/Kxaz/ycSq/87Jrv/a1Ln/6ePH//jx1v///eL////p////6////ef///Tf//bp1//v4ND/69vN/+vZzv/u29P/9ODa//rl4f//6uj//+3t///u8P//7/H//+/x/wCBAH7/AP/96////ev///3q///65//69eH/8ezX/+Xgyv/Y07z/zMiw/8XAp//Ev6X/ycSp/9TPtP/j3cH/8evQ//322///++L///ri//703f/26dX/7N7M/+TVxf/fz8H/383C/+LPx//o1M7/79nV//Xe3P/54uH//OTl//3k5v/95ef/AIEAfv8A/Pjn//345//8+Ob/+vbk//Xx3v/s6NT/4dzH/9TQuf/IxKz/wbyk/7+7of/Ev6X/z8mv/93XvP/r5Mr/9u/V//zz2v/78tr/9evV/+zgzP/i1ML/2cq7/9XEt//Uwrf/2MS8/97Jw//lz8v/69TS//DY2P/z2tv/9Nvd//Tb3v8AgQB+/wD49eX/+fXl//n15P/38+L/8u7c/+nm0//e2sb/0c64/8bCq/++uqL/vLif/8G8o//Lxqz/2NO5/+bfxv/w6dD/9e3V//Tr1P/u487/5NjF/9rMu//RwrP/zLyv/8y6sP/QvbX/1sK8/93IxP/kzcz/6dHS/+zU1f/u1df/7tXY/wCBAH7/APbz5f/39OX/9/Tl//Xz4v/x7t3/6ebU/93bx//Rzrr/xcKt/726pP+7uKD/v7uj/8nErP/V0bj/4t3E/+zmzv/x6tL/8OfR/+nfy//g1MH/1ci3/82+sP/IuKz/yLet/8y5sv/Tv7r/2sXC/+HLyv/mz9D/6tLU/+vT1v/s09f/AIEAfv8A9fTm//b05//39ef/9vTl//Lw4P/q6Nj/393L/9LRvv/HxbH/v72n/7y6pP/Avab/ycau/9XRuv/i3cX/6+bO//Dp0//u5tH/6N/L/97Uwv/UyLj/zL6x/8i5rf/It6//zbq0/9TAvP/bx8X/4s3N/+jR0//r1Nf/7dXZ/+7W2v8AgQB+/wD29ur/9/fr//j46//39+r/9PTl/+3s3f/i4tL/1tbE/8rKt//Cwq7/v76p/8LBq//LybP/19S+/+Pfyf/s6NL/8evW//Dp1f/p4c//4NbG/9fLvf/Pwrb/y72z/8y8tf/RwLv/2MbD/+DMzP/o0tT/7dfa//Da3v/y2+D/89zh/wCBAH7/APf47v/4+e//+vvw//r77//3+Oz/8PLk/+bo2f/a3Mz/z9C//8fItf/ExLH/xsay/8/Ouf/a2cT/5uTP/+/s2P/08Nz/8+3b/+3m1f/l3M3/3NLE/9XJvv/Sxbz/08S+/9jIxP/gzsz/6NXV/+/b3f/14OP/+OLn//rj6f/65Or/AIEAfv8A+Pvz//n89P/7/vX//P/1//r98v/09+v/6+7h/9/i1P/U18f/zM6+/8nLuf/Lzbr/09TB/97ey//q6db/8/Hf//j14//48+P/8+3d/+vj1v/i2s7/3NLI/9rOx//czsn/4dLP/+nY2P/x3+H/+OXo//3p7v//6/L//+30///t9P8AgQB+/wD5/ff/+v/4//3/+v/+//v//f/5//j88v/v9Oj/5Onc/9nd0P/R1cb/zdHB/9DTwv/X2sj/4uTS/+7v3f/49+b//fvr//366//49Ob/8evf/+ri2P/k29P/4tjS/+XY1f/q3Nv/8uLj//np7P//7vP///L5///0/P//9f3///X+/wCBAH7/APn/+v/7//z//v////////////7/+//5//P57//o7uP/3ePX/9Xbzv/S18n/1NnJ/9vf0P/m6tn/8vTk//z97f////L////z//777//48+j/8evi/+zk3f/q4d3/7eLg//Lm5v/56+7///H2///2/P//+f////v////7////+///AIEAfv8A+P/9//r////+///////////////9//7/9v72/+zz6v/h6d7/2eDV/9bc0P/Y3tD/3+TW/+ru4P/1+ev////0////+f////r////2//368f/38uv/8uzn//Hp5v/z6en/+O3v///y9v//9/3///z////+//////////7////+//8AgQB+/wD3////+v////7////////////////////4//v/7vjw/+Tt5P/c5dv/2eHW/9vi1v/i6dz/7PPl//j98P////n///////////////3////4//v48v/38u7/9u/t//jv8P/88vX///f8///7//////////////////////////7//wCBAH7/APb////5/////f////////////////////r////x+/X/5/Hq/9/p4P/b5dv/3ebb/+Ts4f/v9ur/+v/1/////v////////////////////3///34//r39P/58/P/+/P1///2+v//+v////3////////////////////+/////f//AIEAfv8A9v////n////9////////////////////+/////P++f/p9O7/4ezk/93o3//f6d//5u/l//D57v/8//n///////////////////////////////z//fr4//v29//89vn///j9///7/////f/////////+/////f////v////5//8AgQB+/wD1////+P////3////////////////////9////9P/8/+v38f/j7+j/3+vj/+Hs4//n8uj/8vvx//3/+//////////////////////////////////+/Pv//Pj5//33+///+f7///v////9/////f////z////6////9/////b//wCBAH7/APX////4/////f////////////////////7////1////7Pn0/+Tx6v/g7OX/4u3l/+jz6v/y/PP//v/9///////////////////////////////////9/f/8+fv//fj8///5////+v////z////8////+v////f////0////8///AYEAfv8A9f////j////9/////////////////////v////b////s+vX/5fLs/+Ht5v/i7ub/6fTr//P99P/+//7///////////////////////////////////79//36/P/9+Pz///n////6////+/////v////5////9v////P///7x//8oZgvGD7KTrwAAAABJRU5ErkJggg== Developers can then use this to render a preview of the asset, while the actual asset is loaded in a NFT gallery/marketplace, etc. [Enhanced Bitcoin Support](https://goldrush.dev/docs/resources/enhanced-bitcoin-support) [Enhanced Spam Lists](https://goldrush.dev/docs/resources/enhanced-spam-lists) ⌘I --- # Enhanced Spam Lists - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/resources/enhanced-spam-lists#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Resources Enhanced Spam Lists [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Step 1. Install the Package](https://goldrush.dev/docs/resources/enhanced-spam-lists#step-1-install-the-package) * [Step 2. Use Cases](https://goldrush.dev/docs/resources/enhanced-spam-lists#step-2-use-cases) The GoldRush Enhanced Spam Lists are a public good designed to restore trust and transparency in the Web3 ecosystem by helping developers, explorers, wallets, and indexers protect their users from scam tokens and malicious contracts. The Enhanced Spam Lists can be accessed as an [npm package](https://www.npmjs.com/package/@covalenthq/goldrush-enhanced-spam-lists) . This package requires Node.js v18 or above. ### [​](https://goldrush.dev/docs/resources/enhanced-spam-lists#step-1-install-the-package) Step 1. Install the Package You can install the package using npm, yarn or pnpm: npm yarn pnpm Copy Ask AI npm install @covalenthq/goldrush-enhanced-spam-lists ### [​](https://goldrush.dev/docs/resources/enhanced-spam-lists#step-2-use-cases) Step 2. Use Cases 1 Verify if an ERC20 token is spam on a given network Copy Ask AI import { Networks, isERC20Spam, } from "@covalenthq/goldrush-enhanced-spam-lists"; // With default options const isSpam = await isERC20Spam("0xTokenAddress", Networks.ETHEREUM_MAINNET); console.log(isSpam); 2 For a potential spam check for an ERC20 token, Confidence.MAYBE can be used Copy Ask AI import { Confidence, Networks, isERC20Spam, } from "@covalenthq/goldrush-enhanced-spam-lists"; const isPotentialSpam = await isERC20Spam( "0xTokenAddress", Networks.POLYGON_MAINNET, Confidence.MAYBE ); console.log(isPotentialSpam); 3 Verify if an NFT token is spam on a given network Copy Ask AI import { Networks, isNFTSpam, } from "@covalenthq/goldrush-enhanced-spam-lists"; const isNftSpam = await isNFTSpam("0xNftAddress", Networks.BSC_MAINNET); console.log(isNftSpam); 4 Control caching behavior Copy Ask AI import { Networks, Confidence, isERC20Spam, clearCache, } from "@covalenthq/goldrush-enhanced-spam-lists"; // With caching enabled (default) const withCache = await isERC20Spam( "0xTokenAddress", Networks.ETHEREUM_MAINNET, Confidence.YES, true // Enable caching (default) ); // Without caching (always fetches fresh data) const withoutCache = await isERC20Spam( "0xTokenAddress", Networks.ETHEREUM_MAINNET, Confidence.YES, false // Disable caching ); // Clear memory and disk cache if needed clearCache(); 5 For more control, you can get the full lists: Copy Ask AI import { getERC20List, getNFTList, Confidence, Networks, } from "@covalenthq/goldrush-enhanced-spam-lists"; // Get ERC20 spam list with default caching const ethSpamTokens = await getERC20List(Networks.ETHEREUM_MAINNET, Confidence.YES); // Get NFT spam list with caching disabled const bscSpamNfts = await getNFTList(Networks.BSC_MAINNET, false); 6 Get the specific spam score for a given contract Copy Ask AI import { getERC20List, getSpamScore, Networks, Confidence, } from "@covalenthq/goldrush-enhanced-spam-lists"; const ethSpamTokens = await getERC20List( Networks.ETHEREUM_MAINNET, Confidence.YES ); const score = getSpamScore(ethSpamTokens[0]); console.log(score); // Returns the spam score as a string [NFT Supported Formats](https://goldrush.dev/docs/resources/nft-supported-formats) ⌘I --- # ADI Chain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/adi-chain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains ADI Chain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/adi-chain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/adi-chain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/adi-chain#mainnet) * [Testnet](https://goldrush.dev/docs/chains/adi-chain#testnet) * [API Usage](https://goldrush.dev/docs/chains/adi-chain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/adi-chain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/adi-chain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/adi-chain#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/adi-chain#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/adi-chain#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/adi-chain#pricing-api) * [Security API](https://goldrush.dev/docs/chains/adi-chain#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/adi-chain#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/adi-chain#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/adi-chain#additional-resources) [​](https://goldrush.dev/docs/chains/adi-chain#overview) Overview -------------------------------------------------------------------- GoldRush offers the most comprehensive ADI Chain 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 ADI Chain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/adi-chain#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/adi-chain#mainnet) Mainnet ------------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `adi-mainnet` | | **Chain ID** | `36900` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [ADI Block Explorer](https://explorer.adifoundation.ai/) | | **Official Website** | [ADI Chain Website](https://www.adi.foundation/) | | **Native Gas Token** | ADI | [​](https://goldrush.dev/docs/chains/adi-chain#testnet) Testnet ------------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `adi-testnet` | | **Chain ID** | `99999` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [ADI Testnet Block Explorer](https://explorer.testnet.adifoundation.ai/) | | **Official Website** | [ADI Testnet Website](https://www.adi.foundation/) | | **Native Gas Token** | ADI | [​](https://goldrush.dev/docs/chains/adi-chain#api-usage) API Usage ---------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/adi-chain#chain-name) Chain Name * `adi-mainnet` (mainnet) * `adi-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/adi-chain#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (ADI Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/adi-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/adi-chain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (ADI Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "adi-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/adi-chain#foundational-api-support) Foundational API Support ---------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/adi-chain#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/adi-chain#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/adi-chain#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/adi-chain#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/adi-chain#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/adi-chain#additional-resources) Additional Resources -------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Avalanche C-Chain](https://goldrush.dev/docs/chains/avalanche-c-chain) [ApeChain](https://goldrush.dev/docs/chains/apechain) ⌘I --- # Arc Testnet - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/arc#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Arc Testnet [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/arc#overview) * [Supported APIs](https://goldrush.dev/docs/chains/arc#supported-apis) * [Network Details](https://goldrush.dev/docs/chains/arc#network-details) * [Testnet](https://goldrush.dev/docs/chains/arc#testnet) * [API Usage](https://goldrush.dev/docs/chains/arc#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/arc#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/arc#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/arc#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/arc#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/arc#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/arc#pricing-api) * [Security API](https://goldrush.dev/docs/chains/arc#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/arc#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/arc#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/arc#additional-resources) [​](https://goldrush.dev/docs/chains/arc#overview) Overview -------------------------------------------------------------- GoldRush offers the most comprehensive Arc Testnet 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 Arc Testnet Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/arc#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/arc#network-details) Network Details ---------------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `arc-testnet` | | **Chain ID** | `5042002` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Arc Testnet Explorer](https://testnet.arcscan.app/) | | **Official Website** | [Arc Testnet Website](https://www.adi.foundation/) | | **Native Gas Token** | USDC | [​](https://goldrush.dev/docs/chains/arc#testnet) Testnet ------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `arc-testnet` | | **Chain ID** | `5042002` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Arc Testnet Explorer](https://testnet.arcscan.app/) | | **Official Website** | [Arc Testnet Website](https://www.adi.foundation/) | | **Native Gas Token** | USDC | [​](https://goldrush.dev/docs/chains/arc#api-usage) API Usage ---------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/arc#chain-name) Chain Name * `arc-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/arc#example-api-calls) Example API Calls Chain Name Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/arc-testnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/arc#sdk-usage) SDK Usage TypeScript SDK Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "arc-testnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/arc#foundational-api-support) Foundational API Support ---------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/arc#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/arc#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/arc#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/arc#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/arc#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/arc#additional-resources) Additional Resources -------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Arbitrum Nova](https://goldrush.dev/docs/chains/arbitrum-nova) [Axie/Ronin](https://goldrush.dev/docs/chains/axie-ronin) ⌘I --- # Quickstart - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation GoldRush Streaming API Quickstart [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Prerequisites](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#prerequisites) * [Connection](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#connection) * [OHLCV Token Stream Code Samples](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#ohlcv-token-stream-code-samples) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#response-format) * [GraphQL Playground](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#graphql-playground) [​](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#prerequisites) Prerequisites ----------------------------------------------------------------------------------------------- Using any of the GoldRush developer tools requires an API key.[Get Started\ -----------\ \ Sign up for a free API key to get started with GoldRush.](https://goldrush.dev/platform/auth/register/) [​](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#connection) Connection ----------------------------------------------------------------------------------------- The Streaming API supports GraphQL subscriptions over WebSocket, using the [GraphQL over WebSocket](https://github.com/enisdenjo/graphql-ws/blob/master/PROTOCOL.md) protocol. The recommended approach is to use the official [TypeScript Client SDK](https://www.npmjs.com/package/@covalenthq/client-sdk) which supports the Streaming API and manages all WebSocket connections. npm yarn Copy Ask AI npm install @covalenthq/client-sdk You can also use a GraphQL over WebSocket protocol npm package like [`graphql-ws`](https://www.npmjs.com/package/graphql-ws) . If you’re not using the `graphql-ws` package, you must set the WebSocket protocol header:`"Sec-WebSocket-Protocol" : "graphql-transport-ws"`This header is required for the server to properly recognize and handle your GraphQL subscription requests. [​](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#ohlcv-token-stream-code-samples) OHLCV Token Stream Code Samples ----------------------------------------------------------------------------------------------------------------------------------- The following examples show how to connect and subscribe to the OHLCV Token stream using your preferred language or tool. Each sample connects to the WebSocket endpoint, authenticates with your API key, and streams real-time OHLCV updates for a token on Base Mainnet. GoldRush SDK TypeScript (graphql-ws) Python Terminal (websocat) Copy Ask AI import { GoldRushClient, StreamingChain, StreamingInterval, StreamingTimeframe } from "@covalenthq/client-sdk"; const client = new GoldRushClient( "", {}, { onConnecting: () => console.log("Connecting to streaming service..."), onOpened: () => console.log("Connected to streaming service!"), onClosed: () => console.log("Disconnected from streaming service"), onError: (error) => console.error("Streaming error:", error), } ); client.StreamingService.subscribeToOHLCVTokens( { chain_name: StreamingChain.BASE_MAINNET, token_addresses: ["0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"], interval: StreamingInterval.ONE_MINUTE, timeframe: StreamingTimeframe.ONE_HOUR, }, { next: (data) => { console.log("Received OHLCV token data:", data); }, error: (error) => { console.error("Streaming error:", error); }, complete: () => { console.log("Stream completed"); }, } ); [​](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#response-format) Response Format --------------------------------------------------------------------------------------------------- Here is an example of the response you should receive from the above code samples: Copy Ask AI { "data": { "ohlcvCandlesForToken": [\ {\ "chain_name": "BASE_MAINNET",\ "interval": "ONE_MINUTE",\ "timeframe": "ONE_HOUR",\ "timestamp": "2025-06-27T22:24:00Z",\ "open": 0.000604418526534047,\ "high": 0.000604638206820701,\ "low": 0.000604013151624892,\ "close": 0.000604638206820701,\ "volume": 1.4980526133065126,\ "volume_usd": 6004669.256018968,\ "quote_rate": 0.000604638206820701,\ "quote_rate_usd": 4007551.6142841205,\ "base_token": {\ "contract_name": "Virtual Protocol",\ "contract_address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",\ "contract_decimals": 18,\ "contract_ticker_symbol": "VIRTUAL"\ }\ }\ ] } } [​](https://goldrush.dev/docs/goldrush-streaming-api/quickstart#graphql-playground) GraphQL Playground --------------------------------------------------------------------------------------------------------- [Overview](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Authentication](https://goldrush.dev/docs/goldrush-streaming-api/authentication) ⌘I --- # Authentication - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/authentication#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation GoldRush Streaming API Authentication [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Why is Authentication Required?](https://goldrush.dev/docs/goldrush-streaming-api/authentication#why-is-authentication-required) * [1\. Obtaining a GoldRush API Key](https://goldrush.dev/docs/goldrush-streaming-api/authentication#1-obtaining-a-goldrush-api-key) * [2\. Supplying the API Key from the Client](https://goldrush.dev/docs/goldrush-streaming-api/authentication#2-supplying-the-api-key-from-the-client) * [Use the GoldRush Client SDK (recommended)](https://goldrush.dev/docs/goldrush-streaming-api/authentication#use-the-goldrush-client-sdk-recommended) * [Use a GraphQL WebSocket Client](https://goldrush.dev/docs/goldrush-streaming-api/authentication#use-a-graphql-websocket-client) * [Use websocat for Manual WebSocket Testing](https://goldrush.dev/docs/goldrush-streaming-api/authentication#use-websocat-for-manual-websocket-testing) * [3\. Server-Side Authentication Process](https://goldrush.dev/docs/goldrush-streaming-api/authentication#3-server-side-authentication-process) * [4\. Error Handling](https://goldrush.dev/docs/goldrush-streaming-api/authentication#4-error-handling) * [5\. Frequently Asked Questions (FAQ)](https://goldrush.dev/docs/goldrush-streaming-api/authentication#5-frequently-asked-questions-faq) This document provides a comprehensive overview of the authentication process for GraphQL subscriptions with the Streaming API. It covers the rationale for authentication, how to obtain and use an API key, client-side implementation examples, server-side validation, error handling, and frequently asked questions. [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#why-is-authentication-required) Why is Authentication Required? -------------------------------------------------------------------------------------------------------------------------------------- Authentication is essential to ensure that only authorized users can access premium or rate-limited real-time data streams. **All clients must present a valid GoldRush API key to interact with the GraphQL subscription endpoints.** [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#1-obtaining-a-goldrush-api-key) 1\. Obtaining a GoldRush API Key --------------------------------------------------------------------------------------------------------------------------------------- To begin, register for an API key at [GoldRush API Dashboard](https://goldrush.dev/platform/auth/register/) . This key will be required for all authenticated requests to the Streaming API. [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#2-supplying-the-api-key-from-the-client) 2\. Supplying the API Key from the Client --------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#use-the-goldrush-client-sdk-recommended) Use the GoldRush Client SDK (recommended) The recommended approach is to use the official [GoldRush TypeScript Client SDK](https://www.npmjs.com/package/@covalenthq/client-sdk) which handles authentication automatically and provides a simplified interface for managing stream subscriptions. Copy Ask AI npm install @covalenthq/client-sdk Copy Ask AI import { GoldRushClient, StreamingChain, StreamingInterval, StreamingTimeframe } from "@covalenthq/client-sdk"; const client = new GoldRushClient( "", // Your GoldRush API key {}, { onConnecting: () => console.log("Connecting to streaming service..."), onOpened: () => console.log("Connected to streaming service!"), onClosed: () => console.log("Disconnected from streaming service"), onError: (error) => console.error("Streaming error:", error), } ); // Subscribe to OHLCV tokens stream client.StreamingService.subscribeToOHLCVTokens( { chain_name: StreamingChain.BASE_MAINNET, token_addresses: ["0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b"], interval: StreamingInterval.ONE_MINUTE, timeframe: StreamingTimeframe.ONE_HOUR, }, { next: (data) => { console.log("Received OHLCV token data:", data); }, error: (error) => { console.error("Streaming error:", error); }, complete: () => { console.log("Stream completed"); }, } ); The SDK automatically handles: * WebSocket connection management * API key authentication * Connection retry logic * Error handling * Type safety for parameters ### [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#use-a-graphql-websocket-client) Use a GraphQL WebSocket Client For direct WebSocket connections, you can use a package like [graphql-ws](https://github.com/enisdenjo/graphql-ws) library. Below is an example implementation in Node.js: Copy Ask AI import { createClient } from "graphql-ws"; const client = createClient({ url: "wss://gr-staging-v2.streaming.covalenthq.com/graphql", connectionParams: { GOLDRUSH_API_KEY: "YOUR_API_KEY_HERE", // Replace with your GoldRush API key }, }); (async () => { await client.subscribe( { query: `subscription { newPairs { ...fields } }`, }, { next: (data) => console.log("Received data:", data), error: (err) => console.error("Subscription error:", err), complete: () => console.log("Subscription complete"), } ); })(); > **Note:** The API key must be provided as `GOLDRUSH_API_KEY` within the `connectionParams` object. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#use-websocat-for-manual-websocket-testing) Use `websocat` for Manual WebSocket Testing For manual testing or debugging, [websocat](https://github.com/vi/websocat) can be used to interact with the WebSocket endpoint directly from the command line. 1 Step 1: Initiate the WebSocket Connection Copy Ask AI websocat -H="Sec-WebSocket-Protocol: graphql-transport-ws" wss://gr-staging-v2.streaming.covalenthq.com/graphql 2 Step 2: Send the Connection Initialization Payload Send the following JSON as your first message, replacing `` with your actual API key: Copy Ask AI { "type": "connection_init", "payload": { "GOLDRUSH_API_KEY": "" } } Wait for a `connection_ack` response from the server before proceeding. 3 Step 3: Submit a Subscription Query You may now send a subscription query, for example: Copy Ask AI { "id": "74bb224c-22c6-4a0f-ad85-d43a8c4e49ce", "type": "subscribe", "payload": { "query": "subscription {newPairs(chain_name: BASE_MAINNET) { chain_name protocol protocol_version event_name tx_hash block_signed_at pair_address pair_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } base_token_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } quote_token_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } deployer_address quote_rate quote_rate_usd liquidity market_cap supply prices { last_5m last_1hr last_6hr last_24hr } swaps { last_5m last_1hr last_6hr last_24hr }}}" } } If authentication is successful, you will begin receiving real-time data for your subscription. [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#3-server-side-authentication-process) 3\. Server-Side Authentication Process --------------------------------------------------------------------------------------------------------------------------------------------------- * The server **does not** validate the API key at the time of WebSocket connection establishment. * Instead, authentication is enforced at the start of each GraphQL subscription resolver. * If the API key is missing or invalid, the subscription will immediately terminate with an error message. [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#4-error-handling) 4\. Error Handling ----------------------------------------------------------------------------------------------------------- If authentication fails, the client will receive a GraphQL error with one of the following codes: * `MISSING_TOKEN`: No API key was provided in the `connection_init` payload. * `INVALID_TOKEN`: The provided API key is malformed or invalid. * `AUTH_SYSTEM_ERROR`: An internal server error occurred during authentication. **Example Error Response:** Copy Ask AI { "errors": [\ {\ "message": "Authentication required. Please provide a valid API key in the connection_init payload under 'GOLDRUSH_API_KEY' or 'Authorization' key.",\ "extensions": {\ "code": "MISSING_TOKEN"\ }\ }\ ] } [​](https://goldrush.dev/docs/goldrush-streaming-api/authentication#5-frequently-asked-questions-faq) 5\. Frequently Asked Questions (FAQ) --------------------------------------------------------------------------------------------------------------------------------------------- * **What is the client experience if the key is invalid?** * The client will always receive a `connection_ack` response, even if the API key is invalid. Authentication errors are only reported when a subscription is initiated. * **Where is the API key expected?** * The API key is expected in the `payload` of the `connection_init` message with the key `GOLDRUSH_API_KEY`. * **What API key formats are supported?** * `cqt_wF[26 base58 chars]` or `cqt_rQ[26 base58 chars]` * **Why should I use the Client SDK?** * The Client SDK provides automatic authentication, connection management, retry logic, type safety, and a simplified API for all streaming operations. [Quickstart](https://goldrush.dev/docs/goldrush-streaming-api/quickstart) [SDK Guide](https://goldrush.dev/docs/goldrush-streaming-api/sdk) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/platform#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [SX Network](https://goldrush.dev/docs/chains/sx-network#) [Manta Pacific Testnet](https://goldrush.dev/docs/chains/manta-pacific#) [SDK Guide](https://goldrush.dev/docs/goldrush-streaming-api/sdk#) ⌘I --- # Get token balances for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Balances Get token balances for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "contract_display_name": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "logo_urls": {\ "token_logo_url": "",\ "protocol_logo_url": "",\ "chain_logo_url": ""\ },\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "balance_24h": "",\ "quote_rate": 123,\ "quote_rate_24h": 123,\ "quote": 123,\ "quote_24h": 123,\ "pretty_quote": "",\ "pretty_quote_24h": "",\ "protocol_metadata": {\ "protocol_name": ""\ }\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / balances\_v2 Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "contract_display_name": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "logo_urls": {\ "token_logo_url": "",\ "protocol_logo_url": "",\ "chain_logo_url": ""\ },\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "balance_24h": "",\ "quote_rate": 123,\ "quote_rate_24h": 123,\ "quote": 123,\ "quote_24h": 123,\ "pretty_quote": "",\ "pretty_quote_24h": "",\ "protocol_metadata": {\ "protocol_name": ""\ }\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime Related guides [Understanding Web3 Wallets with GoldRush](https://goldrush.dev/guides/understanding-web3-wallets) [Building Web3 Wallets (Part 2) - Curve LP Token Balances](https://goldrush.dev/guides/building-wallets-part-2-curve-lp-tokens-balances) [Building Web3 Wallets (Part 1) - Token Displays](https://goldrush.dev/guides/building-web3-wallets-part-1-token-displays) [How to Block NFT Spam](https://goldrush.dev/guides/how-to-block-spam-nft-tokens) [Calculate Crypto Cost Basis and Capital Gains with GoldRush](https://goldrush.dev/guides/calculate-crypto-cost-basis-and-capital-gains-with-covalent) [Comprehensive Guide to Bitcoin Wallet Address Lookup and Transaction Tracking](https://goldrush.dev/guides/comprehensive-guide-to-bitcoin-wallet-lookup-and-transaction-tracking) [How to Get Bitcoin Balances and Transactions](https://goldrush.dev/guides/how-to-get-bitcoin-balances-and-transactions) [DIY - Build Your Own Crypto Tax Calculator with Google Sheets](https://goldrush.dev/guides/diy-build-your-own-crypto-tax-calculator-with-google-sheets) [Comparing GoldRush’s Token Balances API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-token-balances-to-rpc) [Building a Web3 Portfolio Tracker with the GoldRush API](https://goldrush.dev/guides/building-a-web3-portfolio-tracker-with-the-covalent-api) [How to Use Covalent’s Wallet Transaction Analysis Tool](https://goldrush.dev/guides/how-to-use-covalent-s-wallet-transaction-analysis-tool) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#parameter-no-spam) no-spam boolean If `true`, the suspected spam tokens are removed. Supported on all Foundational Chains. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address#response-items) items object\[\] List of response items. Show child attributes [Get multichain & multiaddress transactions](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-transactions) [Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) ⌘I --- # Get token approvals for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Security Get token approvals for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.SecurityService.getApprovals({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "token_address": "",\ "token_address_label": "",\ "ticker_symbol": "",\ "contract_decimals": 123,\ "logo_url": "",\ "quote_rate": 123,\ "balance": "",\ "balance_quote": 123,\ "pretty_balance_quote": "",\ "value_at_risk": "",\ "value_at_risk_quote": 123,\ "pretty_value_at_risk_quote": "",\ "spenders": [\ {\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "block_signed_at": "2023-11-07T05:31:56Z",\ "tx_hash": "",\ "spender_address": "",\ "spender_address_label": "",\ "allowance": "",\ "allowance_quote": 123,\ "pretty_allowance_quote": "",\ "value_at_risk": "",\ "value_at_risk_quote": 123,\ "pretty_value_at_risk_quote": "",\ "risk_factor": ""\ }\ ]\ }\ ] } GET / v1 / {chainName} / approvals / {walletAddress} Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.SecurityService.getApprovals({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "token_address": "",\ "token_address_label": "",\ "ticker_symbol": "",\ "contract_decimals": 123,\ "logo_url": "",\ "quote_rate": 123,\ "balance": "",\ "balance_quote": 123,\ "pretty_balance_quote": "",\ "value_at_risk": "",\ "value_at_risk_quote": 123,\ "pretty_value_at_risk_quote": "",\ "spenders": [\ {\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "block_signed_at": "2023-11-07T05:31:56Z",\ "tx_hash": "",\ "spender_address": "",\ "spender_address_label": "",\ "allowance": "",\ "allowance_quote": 123,\ "pretty_allowance_quote": "",\ "value_at_risk": "",\ "value_at_risk_quote": 123,\ "pretty_value_at_risk_quote": "",\ "risk_factor": ""\ }\ ]\ }\ ] } Credit Cost ----------- 2 per call Processing ---------- Realtime Related guides [Building Web3 Wallets (Part 5) - Revoking Approvals for Your Wallet](https://goldrush.dev/guides/building-web3-wallets-part-5-revoking-approvals-for-your-wallet) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address#response-items) items object\[\] List of response items. Show child attributes [Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) [Get Bitcoin balances for HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address) ⌘I --- # Get Bitcoin balance for non-HD address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Bitcoin Get Bitcoin balance for non-HD address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getBitcoinBalanceForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "contract_display_name": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "logo_urls": {\ "token_logo_url": "",\ "protocol_logo_url": "",\ "chain_logo_url": ""\ },\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "balance_24h": "",\ "quote_rate": 123,\ "quote_rate_24h": 123,\ "quote": 123,\ "quote_24h": 123,\ "pretty_quote": "",\ "pretty_quote_24h": "",\ "protocol_metadata": {\ "protocol_name": ""\ }\ }\ ] } GET / v1 / btc-mainnet / address / {walletAddress} / balances\_v2 Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getBitcoinBalanceForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "contract_display_name": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "logo_urls": {\ "token_logo_url": "",\ "protocol_logo_url": "",\ "chain_logo_url": ""\ },\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "balance_24h": "",\ "quote_rate": 123,\ "quote_rate_24h": 123,\ "quote": 123,\ "quote_24h": 123,\ "pretty_quote": "",\ "pretty_quote_24h": "",\ "protocol_metadata": {\ "protocol_name": ""\ }\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#parameter-wallet-address) walletAddress string required The requested bitcoin non-HD address. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address#response-items) items object\[\] List of response items. Show child attributes [Get Bitcoin balances for HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address) [Get historical Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address) ⌘I --- # Get transaction summary for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get transaction summary for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getTransactionSummary({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "address": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "total_count": 123,\ "transfer_count": 123,\ "earliest_transaction": {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "tx_hash": "",\ "tx_detail_link": ""\ },\ "latest_transaction": {},\ "gas_summary": {\ "total_sent_count": 123,\ "total_fees_paid": "",\ "total_gas_quote": 123,\ "pretty_total_gas_quote": "",\ "average_gas_quote_per_tx": 123,\ "pretty_average_gas_quote_per_tx": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ }\ }\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / transactions\_summary Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getTransactionSummary({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "address": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "total_count": 123,\ "transfer_count": 123,\ "earliest_transaction": {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "tx_hash": "",\ "tx_detail_link": ""\ },\ "latest_transaction": {},\ "gas_summary": {\ "total_sent_count": 123,\ "total_fees_paid": "",\ "total_gas_quote": 123,\ "pretty_total_gas_quote": "",\ "average_gas_quote_per_tx": 123,\ "pretty_average_gas_quote_per_tx": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ }\ }\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Batch * Base cost is `1` credit. * Using `with-gas` is an additional `1` credit. * Using `with-transfer-count` is an additional `3` credits. Related guides [Building Web3 Wallets (Part 7) - Multi-Chain Wallet Activity Summary](https://goldrush.dev/guides/building-web3-wallets-part-7-multi-chain-wallet-activity-summary) [How Token Gating and Membership dApps Use the GoldRush API](https://goldrush.dev/guides/how-token-gating-dapps-use-the-covalent-api) [Comparing GoldRush’s Transactions API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) [How to Get Transaction History for an Address on Ethereum](https://goldrush.dev/guides/how-to-get-transaction-history-for-an-address-on-ethereum) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#parameter-with-gas) with-gas boolean Include gas summary details. Response times may be impacted for wallets with large number of transactions. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#parameter-with-transfer-count) with-transfer-count boolean Represents the total count of ERC-20 token movement events, including `Transfer`, `Deposit` and `Withdraw`. Response times may be impacted for wallets with large number of transactions. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address#response-items) items object\[\] List of response items. Show child attributes [Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ⌘I --- # New DEX Pairs Stream - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Available Streams New DEX Pairs Stream [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Parameters](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#parameters) * [Subscription](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#subscription) * [Basic Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#basic-subscription-query) * [Complete Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#complete-subscription-query) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#response-format) * [Field Descriptions](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#field-descriptions) The New DEX Pairs stream provides real-time updates when **new liquidity pairs** are created on decentralized exchanges (DEXes). This documentation follows our standard streaming API structure. Credit Cost ----------- TBD Supported Chains ---------------- * `BASE_MAINNET` * `BSC_MAINNET` * `ETH_MAINNET` * `SONIC_MAINNET` * `SOLANA_MAINNET` * `MONAD_MAINNET` **This stream is currently in Beta.** It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. **No API credits are currently charged.**We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#ee9d9b9e9e819c9aae8d81988f828b809a869fc08d8183) to us directly to report issues or request features. [​](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#parameters) Parameters --------------------------------------------------------------------------------------------------- | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `chain_name` | `enum` | Yes | Chain name to filter events (e.g., `BASE_MAINNET`, `ETH_MAINNET`, `BSC_MAINNET`, `SOLANA_MAINNET`) | | `protocols` | `array` | Yes | List of protocol name enums to filter events (e.g.,`[UNISWAP_V2, RAYDIUM_AMM]`); see [supported DEXes](https://goldrush.dev/docs/goldrush-streaming-api/overview#supported-chains-%26-dexes)
for the full list. | [​](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#subscription) Subscription ------------------------------------------------------------------------------------------------------- You can subscribe to the `newPairs` endpoint to receive events. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#basic-subscription-query) Basic Subscription Query Copy Ask AI subscription { newPairs(chain_name: BASE_MAINNET, protocols: [UNISWAP_V2, UNISWAP_V3]) { chain_name protocol protocol_version tx_hash block_signed_at } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#complete-subscription-query) Complete Subscription Query Copy Ask AI subscription { newPairs(chain_name: BASE_MAINNET, protocols: [UNISWAP_V2, UNISWAP_V3]) { chain_name protocol protocol_version pair_address deployer_address tx_hash block_signed_at liquidity supply market_cap event_name quote_rate quote_rate_usd base_token_metadata { contract_address contract_decimals contract_name contract_ticker_symbol } pair_metadata { contract_address contract_decimals contract_name contract_ticker_symbol } quote_token_metadata { contract_address contract_decimals contract_name contract_ticker_symbol } } } [​](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#response-format) Response Format ------------------------------------------------------------------------------------------------------------- Here’s an example of the response data structure: Copy Ask AI { "data": { "newPairs": [\ {\ "chain_name": "base",\ "protocol": "uniswap",\ "protocol_version": "3",\ "pair_address": "0xa7dfb58a6e0d675c19f76dfd3b8b80a3a4814728",\ "deployer_address": "0x33128a8fc17869897dce68ed026d694621f6fdfd",\ "tx_hash": "0x5374c0182580ff2b3e868f58bdce697f3e4256baebc6f6e8db008fadb32d6253",\ "block_signed_at": "2025-05-28T22:01:41Z",\ "liquidity": 177.50267302070574,\ "supply": 1000000000,\ "market_cap": 6153.261270529,\ "event_name": "PoolCreated",\ "quote_rate": 0.000006153261270529,\ "quote_rate_usd": 0.000006153261270529,\ "base_token_metadata": {\ "contract_address": "0x8ac05571b525dd555320df58a40a0c0ab6d807c7",\ "contract_decimals": 18,\ "contract_name": "GOAT",\ "contract_ticker_symbol": "GOAT"\ },\ "quote_token_metadata": {\ "contract_address": "0x1111111111166b7fe7bd91427724b487980afc69",\ "contract_decimals": 18,\ "contract_name": "Zora",\ "contract_ticker_symbol": "ZORA"\ },\ "pair_metadata": {\ "contract_address": "0xa7dfb58a6e0d675c19f76dfd3b8b80a3a4814728",\ "contract_decimals": 18,\ "contract_name": "GOAT-ZORA Pool",\ "contract_ticker_symbol": "GOAT-ZORA"\ },\ }\ ] } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream#field-descriptions) Field Descriptions | Field | Type | Description | | --- | --- | --- | | `chain_name` | `string` | The blockchain network where the pair was created | | `protocol` | `string` | DEX protocol name (e.g., “uniswap”, “pancakeswap”) | | `protocol_version` | `string` | Version of the DEX protocol | | `pair_address` | `string` | Address of the new pair contract | | `deployer_address` | `string` | Address that deployed the pair contract | | `tx_hash` | `string` | Transaction hash of the pair creation | | `block_signed_at` | `string` | ISO timestamp of when the block was signed | | `liquidity` | `float` | Initial liquidity amount (in USD) | | `supply` | `integer` | Total supply of the pair token | | `market_cap` | `float` | Market capitalization in USD | | `event_name` | `string` | Name of the contract event (e.g., “PoolCreated”) | | `quote_rate` | `float` | Exchange rate between base and quote tokens | | `quote_rate_usd` | `float` | USD value of the quote rate | | `base_token_metadata` | `object` | Metadata for the base token including contract address, decimals, name, and symbol | | `quote_token_metadata` | `object` | Metadata for the quote token including contract address, decimals, name, and symbol | | `pair_metadata` | `object` | Metadata for the pair including contract address, decimals, name, and symbol | [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) ⌘I --- # Get NFTs for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation NFT Get NFTs for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.NftService.getNftsForAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "is_spam": true,\ "last_transfered_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "balance": "",\ "balance_24h": "",\ "type": "",\ "floor_price_quote": 123,\ "pretty_floor_price_quote": "",\ "floor_price_native_quote": 123,\ "nft_data": [\ {\ "token_id": "",\ "token_url": "",\ "original_owner": "",\ "current_owner": "",\ "external_data": {\ "name": "",\ "description": "",\ "asset_url": "",\ "asset_file_extension": "",\ "asset_mime_type": "",\ "asset_size_bytes": "",\ "image": "",\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "animation_url": "",\ "external_url": "",\ "attributes": [\ {\ "trait_type": "",\ "value": ""\ }\ ],\ "thumbnails": {\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "image_opengraph_url": "",\ "thumbhash": ""\ },\ "image_preview": "",\ "asset_properties": {\ "asset_width": 123,\ "asset_height": 123,\ "dominant_color": ""\ }\ },\ "asset_cached": true,\ "image_cached": true\ }\ ]\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / balances\_nft Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.NftService.getNftsForAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "is_spam": true,\ "last_transfered_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "balance": "",\ "balance_24h": "",\ "type": "",\ "floor_price_quote": 123,\ "pretty_floor_price_quote": "",\ "floor_price_native_quote": 123,\ "nft_data": [\ {\ "token_id": "",\ "token_url": "",\ "original_owner": "",\ "current_owner": "",\ "external_data": {\ "name": "",\ "description": "",\ "asset_url": "",\ "asset_file_extension": "",\ "asset_mime_type": "",\ "asset_size_bytes": "",\ "image": "",\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "animation_url": "",\ "external_url": "",\ "attributes": [\ {\ "trait_type": "",\ "value": ""\ }\ ],\ "thumbnails": {\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "image_opengraph_url": "",\ "thumbhash": ""\ },\ "image_preview": "",\ "asset_properties": {\ "asset_width": 123,\ "asset_height": 123,\ "dominant_color": ""\ }\ },\ "asset_cached": true,\ "image_cached": true\ }\ ]\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime Related guides [How to Block NFT Spam](https://goldrush.dev/guides/how-to-block-spam-nft-tokens) [Getting Started with the GoldRush SDK](https://goldrush.dev/guides/getting-started-with-the-covalent-sdk) [Building a Web3 Portfolio Tracker with the GoldRush API](https://goldrush.dev/guides/building-a-web3-portfolio-tracker-with-the-covalent-api) [How to Get All NFTs for Address](https://goldrush.dev/guides/how-to-get-all-nfts-for-address) [Mastering NFT Indexing: GoldRush’s Advanced API for Comprehensive NFT Data](https://goldrush.dev/guides/next-level-nft-indexing-dissecting-nft-portfolios-with-covalent-s-precision-data) [Displaying NFT Holdings with GoldRush’s NFT Endpoints](https://goldrush.dev/guides/from-wallet-to-web-displaying-nft-holdings-with-covalent-s-nft-endpoints) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#parameter-no-spam) no-spam boolean If `true`, the suspected spam tokens are removed. Supported on all Foundational Chains. [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#parameter-no-nft-asset-metadata) no-nft-asset-metadata boolean If `true`, the response shape is limited to a list of collections and token ids, omitting metadata and asset information. Helpful for faster response times and wallets holding a large number of NFTs. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address#response-items) items object\[\] List of response items. Show child attributes [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) [Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) ⌘I --- # OHLCV Tokens Stream - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Available Streams OHLCV Tokens Stream [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Parameters](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#parameters) * [Subscription](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#subscription) * [Basic Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#basic-subscription-query) * [Complete Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#complete-subscription-query) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#response-format) * [Field Descriptions](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#field-descriptions) The OHLCV Tokens stream provides real-time updates on the Open, High, Low, Close prices and Volume of **one or many tokens** at configurable intervals. This documentation follows our standard streaming API structure. Credit Cost ----------- TBD Supported Chains ---------------- * `BASE_MAINNET` * `BSC_MAINNET` * `ETH_MAINNET` * `SONIC_MAINNET` * `SOLANA_MAINNET` * `HYPERCORE_MAINNET` * `MONAD_MAINNET` **This stream is currently in Beta.** It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. **No API credits are currently charged.**We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#cdbeb8bdbda2bfb98daea2bbaca1a8a3b9a5bce3aea2a0) to us directly to report issues or request features. [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#parameters) Parameters -------------------------------------------------------------------------------------------------- | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `chain_name` | `enum` | Yes | Chain name to filter events (e.g. `BASE_MAINNET`, `ETH_MAINNET`, `BSC_MAINNET`, `SOLANA_MAINNET`) | | `token_addresses` | `array` | Yes | Array of token addresses on [supported DEXes](https://goldrush.dev/docs/goldrush-streaming-api/overview#supported-chains-%26-dexes)
and chains to track | | `interval` | `enum` | Yes | Frequency of OHLCV data updates, ranging from sub-second to one day | | `timeframe` | `enum` | Yes | Historical lookback period for OHLCV data, ranging from one minute to one month | | `limit` | `int` | No | Maximum number of items returned per stream message to control payload size | [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#subscription) Subscription ------------------------------------------------------------------------------------------------------ You can subscribe to the `ohlcvCandlesForToken` endpoint to receive the pricing events. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#basic-subscription-query) Basic Subscription Query Copy Ask AI subscription { ohlcvCandlesForToken( chain_name: BASE_MAINNET token_addresses: ["0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"] interval: ONE_MINUTE timeframe: ONE_HOUR ) { chain_name interval timeframe timestamp open high low close volume volume_usd quote_rate quote_rate_usd base_token { contract_name contract_address contract_decimals contract_ticker_symbol } } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#complete-subscription-query) Complete Subscription Query Copy Ask AI subscription { ohlcvCandlesForToken( chain_name: BASE_MAINNET token_addresses: [\ "0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"\ ] interval: ONE_MINUTE timeframe: ONE_HOUR limit: 1000 ) { chain_name pair_address interval timeframe timestamp open high low close volume volume_usd quote_rate quote_rate_usd base_token { contract_name contract_address contract_decimals contract_ticker_symbol } quote_token { contract_name contract_address contract_decimals contract_ticker_symbol } } } [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#response-format) Response Format ------------------------------------------------------------------------------------------------------------ Here’s an example of the response data structure: Copy Ask AI { "data": { "ohlcvCandlesForToken": [\ {\ "chain_name": "BASE_MAINNET",\ "interval": "ONE_MINUTE",\ "timeframe": "ONE_HOUR",\ "timestamp": "2025-06-27T22:24:00Z",\ "open": 0.000604418526534047,\ "high": 0.000604638206820701,\ "low": 0.000604013151624892,\ "close": 0.000604638206820701,\ "volume": 1.4980526133065126,\ "volume_usd": 6004669.256018968,\ "quote_rate": 0.000604638206820701,\ "quote_rate_usd": 4007551.6142841205,\ "base_token": {\ "contract_name": "Virtual Protocol",\ "contract_address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",\ "contract_decimals": 18,\ "contract_ticker_symbol": "VIRTUAL"\ }\ }\ ] } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream#field-descriptions) Field Descriptions | Field | Type | Description | | --- | --- | --- | | `chain_name` | `string` | The blockchain network where the token exists | | `pair_address` | `string` | The address of the primary DEX pool with the most liquidity for the token | | `interval` | `enum` | The candle interval | | `timeframe` | `enum` | The requested timeframe | | `timestamp` | `string` | ISO timestamp for the candle | | `open` | `float` | Opening price for the interval | | `high` | `float` | Highest price during the interval | | `low` | `float` | Lowest price during the interval | | `close` | `float` | Closing price for the interval | | `volume` | `float` | Trading volume during the interval | | `volume_usd` | `float` | Trading volume in USD | | `quote_rate` | `float` | Exchange rate between base and quote tokens | | `quote_rate_usd` | `float` | USD value of the quote rate | | `base_token` | `object` | Information about the queried token | | `quote_token` | `object` | Information about the paired token of the primary DEX pool | [SDK Guide](https://goldrush.dev/docs/goldrush-streaming-api/sdk) [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) ⌘I --- # Get top trading wallets for token - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Available Queries Get top trading wallets for token [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Parameters](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#parameters) * [Query](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#query) * [Basic Query](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#basic-query) * [Complete Query](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#complete-query) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#response-format) * [Field Descriptions](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#field-descriptions) * [GraphQL Playground](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#graphql-playground) This GraphQL query provides a list of wallets with the highest trading volume for a specific token over the last 30 days, along with detailed information about their holdings, transaction activity, realized and unrealized profit/loss metrics. This documentation follows our standard streaming API structure. Credit Cost ----------- TBD Supported Chains ---------------- * Base Mainnet * BSC Mainnet * Ethereum Mainnet * Gnosis Mainnet * Polygon Mainnet * Optimism Mainnet **This query is currently in Beta.** It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. **No API credits are currently charged.**We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#21525451514e535561424e57404d444f5549500f424e4c) to us directly to report issues or request features. [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#parameters) Parameters --------------------------------------------------------------------------------------------- | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `chain_name` | `enum` | Yes | Chain name to filter events (e.g., `BASE_MAINNET`, `ETH_MAINNET`, `BSC_MAINNET`) | | `token_address` | `string` | Yes | The deployed token contract address to query | [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#query) Query ----------------------------------------------------------------------------------- You can query the `upnlForToken` endpoint to retrieve top wallet trading data. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#basic-query) Basic Query Copy Ask AI query { upnlForToken( chain_name: ETH_MAINNET token_address: "0x7ABc8A5768E6bE61A6c693a6e4EAcb5B60602C4D" ) { token address volume balance pnl_realized_usd pnl_unrealized_usd } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#complete-query) Complete Query Copy Ask AI query { upnlForToken( chain_name: ETH_MAINNET token_address: "0x7ABc8A5768E6bE61A6c693a6e4EAcb5B60602C4D" ) { token address volume transactions_count pnl_realized_usd balance balance_pretty pnl_unrealized_usd contract_metadata { contract_address contract_name contract_ticker_symbol contract_decimals } } } [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#response-format) Response Format ------------------------------------------------------------------------------------------------------- Here’s an example of the response data structure: Copy Ask AI { "data": { "upnlForToken": [\ {\ "token": "0x7abc8a5768e6be61a6c693a6e4eacb5b60602c4d",\ "address": "0x91d40e4818f4d4c57b4578d9eca6afc92ac8debe",\ "volume": 56708716,\ "transactions_count": 554,\ "pnl_realized_usd": -43239.81,\ "balance": 3.2944375440228563e+25,\ "balance_pretty": "32944375.4402",\ "pnl_unrealized_usd": 535182,\ "contract_metadata": {\ "contract_address": "0x7ABc8A5768E6bE61A6c693a6e4EAcb5B60602C4D",\ "contract_name": "Covalent X Token",\ "contract_ticker_symbol": "CXT",\ "contract_decimals": 18\ }\ },\ {\ "token": "0x7abc8a5768e6be61a6c693a6e4eacb5b60602c4d",\ "address": "0xfe97b0c517a84f98fc6ede3cd26b43012d31992a",\ "volume": 39102028,\ "transactions_count": 241,\ "pnl_realized_usd": 8799.58,\ "balance": 3.2313896033867796e+26,\ "balance_pretty": "323138960.3387",\ "pnl_unrealized_usd": 6417132,\ "contract_metadata": {\ "contract_address": "0x7ABc8A5768E6bE61A6c693a6e4EAcb5B60602C4D",\ "contract_name": "Covalent X Token",\ "contract_ticker_symbol": "CXT",\ "contract_decimals": 18\ }\ }\ ] } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#field-descriptions) Field Descriptions | Field | Type | Description | | --- | --- | --- | | `token` | `string` | Token contract address, represented in lowercase with a 0x prefix | | `address` | `string` | Wallet address of the token trader, also in lowercase with a 0x prefix | | `volume` | `BigInteger` | Total volume of tokens transferred by this wallet in the past 30 days | | `transactions_count` | `integer` | Number of transactions involving this wallet and token in the past 30 days | | `pnl_realized_usd` | `float` | Realized profit or loss in USD from completed trades | | `balance` | `BigInteger` | Current token balance in raw format (full decimal precision) | | `balance_pretty` | `string` | Human-readable token balance formatted to 4 decimal places | | `pnl_unrealized_usd` | `float` | Unrealized profit or loss in USD based on the current token price | | `contract_metadata` | `object` | Contains metadata details for the token contract | [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token#graphql-playground) GraphQL Playground ------------------------------------------------------------------------------------------------------------- [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) [Get PnL for wallet](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet) ⌘I --- # OHLCV Pairs Stream - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Available Streams OHLCV Pairs Stream [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Parameters](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#parameters) * [Subscription](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#subscription) * [Basic Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#basic-subscription-query) * [Complete Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#complete-subscription-query) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#response-format) * [Field Descriptions](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#field-descriptions) The OHLCV Pairs stream provides real-time updates on the Open, High, Low, Close prices and Volume of **one or many token pairs** at configurable intervals. This documentation follows our standard streaming API structure. Credit Cost ----------- TBD Supported Chains ---------------- * `BASE_MAINNET` * `BSC_MAINNET` * `ETH_MAINNET` * `SOLANA_MAINNET` * `SONIC_MAINNET` * `MONAD_MAINNET` **This stream is currently in Beta.** It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. **No API credits are currently charged.**We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#bac9cfcacad5c8cefad9d5ccdbd6dfd4ced2cb94d9d5d7) to us directly to report issues or request features. [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#parameters) Parameters ------------------------------------------------------------------------------------------------- | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `chain_name` | `enum` | Yes | Chain name to filter events (e.g. `BASE_MAINNET`, `ETH_MAINNET`, `BSC_MAINNET`, `SOLANA_MAINNET`) | | `pair_addresses` | `array` | Yes | Array of pair addresses on [supported DEXes](https://goldrush.dev/docs/goldrush-streaming-api/overview#supported-chains-%26-dexes)
and chains to track | | `interval` | `enum` | Yes | Frequency of OHLCV data updates, ranging from sub-second to one day | | `timeframe` | `enum` | Yes | Historical lookback period for OHLCV data, ranging from one minute to one month | | `limit` | `int` | No | Maximum number of items returned per stream message to control payload size | [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#subscription) Subscription ----------------------------------------------------------------------------------------------------- You can subscribe to the `ohlcvCandlesForPair` endpoint to receive the pricing events. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#basic-subscription-query) Basic Subscription Query Copy Ask AI subscription { ohlcvCandlesForPair( chain_name: BASE_MAINNET pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"] interval: ONE_MINUTE timeframe: ONE_HOUR ) { chain_name pair_address interval timeframe timestamp open high low close volume volume_usd quote_rate quote_rate_usd } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#complete-subscription-query) Complete Subscription Query Copy Ask AI subscription { ohlcvCandlesForPair( chain_name: BASE_MAINNET pair_addresses: [\ "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"\ "0x4b0Aaf3EBb163dd45F663b38b6d93f6093EBC2d3"\ ] interval: ONE_MINUTE timeframe: ONE_HOUR limit: 1000 ) { chain_name pair_address interval timeframe timestamp open high low close volume volume_usd quote_rate quote_rate_usd base_token { contract_name contract_address contract_decimals contract_ticker_symbol } quote_token { contract_name contract_address contract_decimals contract_ticker_symbol } } } [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#response-format) Response Format ----------------------------------------------------------------------------------------------------------- Here’s an example of the response data structure: Copy Ask AI { "data": { "ohlcvCandlesForPair": [\ {\ "chain_name": "BASE_MAINNET",\ "pair_address": "0x4b0Aaf3EBb163dd45F663b38b6d93f6093EBC2d3",\ "interval": "ONE_MINUTE",\ "timeframe": "ONE_HOUR",\ "timestamp": "2025-05-29T19:53:00Z",\ "open": 4113151.389790023,\ "high": 4196665.022060752,\ "low": 4113151.389790023,\ "close": 4196665.022060752,\ "volume": 325.7615900713698,\ "volume_usd": 0.2079461510855417,\ "quote_rate": 4196665.022060752,\ "quote_rate_usd": 0.0006319231563715365,\ "quote_token": {\ "contract_name": "Wrapped Ether",\ "contract_symbol": "WETH",\ "contract_address": "0x4200000000000000000000000000000000000006",\ "contract_decimals": 18\ },\ "base_token": {\ "contract_name": "Toshi",\ "contract_symbol": "TOSHI",\ "contract_address": "0xac1bd2486aaf3b5c0fc3fd868558b082a531b2b4",\ "contract_decimals": 18\ }\ }\ ] } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream#field-descriptions) Field Descriptions | Field | Type | Description | | --- | --- | --- | | `chain_name` | `string` | The blockchain network where the pair exists | | `pair_address` | `string` | The address of the DEX pair | | `interval` | `enum` | The candle interval | | `timeframe` | `enum` | The requested timeframe | | `timestamp` | `string` | ISO timestamp for the candle | | `open` | `float` | Opening price for the interval | | `high` | `float` | Highest price during the interval | | `low` | `float` | Lowest price during the interval | | `close` | `float` | Closing price for the interval | | `volume` | `float` | Trading volume during the interval | | `volume_usd` | `float` | Trading volume in USD | | `quote_rate` | `float` | Exchange rate between base and quote tokens | | `quote_rate_usd` | `float` | USD value of the quote rate | | `base_token` | `object` | Information about the base token in the pair | | `quote_token` | `object` | Information about the quote token in the pair | [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) ⌘I --- # SDK Guide - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/sdk#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation GoldRush Streaming API SDK Guide [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Basic Subscription](https://goldrush.dev/docs/goldrush-streaming-api/sdk#basic-subscription) * [Multiple Subscriptions](https://goldrush.dev/docs/goldrush-streaming-api/sdk#multiple-subscriptions) * [React Integration](https://goldrush.dev/docs/goldrush-streaming-api/sdk#react-integration) * [GraphQL Queries](https://goldrush.dev/docs/goldrush-streaming-api/sdk#graphql-queries) With the official [TypeScript Client SDK](https://www.npmjs.com/package/@covalenthq/client-sdk) , developers can access the Streaming API and leverage the following advanced features described in this guide. Copy Ask AI npm install @covalenthq/client-sdk [​](https://goldrush.dev/docs/goldrush-streaming-api/sdk#basic-subscription) Basic Subscription -------------------------------------------------------------------------------------------------- The following code sample shows how to set up a subscription to the OHLCV Pairs stream: GoldRush SDK Copy Ask AI import { GoldRushClient, StreamingChain, StreamingInterval, StreamingTimeframe, StreamingProtocol, } from "@covalenthq/client-sdk"; const client = new GoldRushClient( "", {}, { onConnecting: () => console.log("Connecting to streaming service..."), onOpened: () => console.log("Connected to streaming service!"), onClosed: () => console.log("Disconnected from streaming service"), onError: (error) => console.error("Streaming error:", error), } ); // Subscribe to OHLCV data for trading pairs const unsubscribeOhlcvPairs = client.StreamingService.subscribeToOHLCVPairs( { chain_name: StreamingChain.BASE_MAINNET, pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"], interval: StreamingInterval.ONE_MINUTE, timeframe: StreamingTimeframe.ONE_HOUR, }, { next: (data) => { console.log("Received OHLCV pair data:", data); }, error: (error) => { console.error("Streaming error:", error); }, complete: () => { console.log("Stream completed"); }, } ); // Unsubscribe when done unsubscribeOhlcvPairs(); // Disconnect from streaming service when finished await client.StreamingService.disconnect(); [​](https://goldrush.dev/docs/goldrush-streaming-api/sdk#multiple-subscriptions) Multiple Subscriptions ---------------------------------------------------------------------------------------------------------- The SDK uses a singleton WebSocket client internally, allowing you to create multiple subscriptions through the same GoldRushClient. GoldRush SDK Copy Ask AI import { GoldRushClient, StreamingChain, StreamingInterval, StreamingTimeframe, StreamingProtocol, } from "@covalenthq/client-sdk"; // Create a single client const client = new GoldRushClient( "", {}, { onConnecting: () => console.log("Connecting to streaming service..."), onOpened: () => console.log("Connected to streaming service!"), onClosed: () => console.log("Disconnected from streaming service"), onError: (error) => console.error("Streaming error:", error), } ); // Create multiple subscriptions through the same connection const unsubscribePairs = client.StreamingService.subscribeToOHLCVPairs( { chain_name: StreamingChain.BASE_MAINNET, pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"], interval: StreamingInterval.ONE_MINUTE, timeframe: StreamingTimeframe.ONE_HOUR, }, { next: (data) => console.log("OHLCV Pairs:", data), } ); const unsubscribeTokens = client.StreamingService.subscribeToOHLCVTokens( { chain_name: StreamingChain.BASE_MAINNET, token_addresses: ["0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"], interval: StreamingInterval.ONE_MINUTE, timeframe: StreamingTimeframe.ONE_HOUR, }, { next: (data) => console.log("OHLCV Tokens:", data), } ); const unsubscribeWallet = client.StreamingService.subscribeToWalletActivity( { chain_name: StreamingChain.BASE_MAINNET, wallet_addresses: ["0xbaed383ede0e5d9d72430661f3285daa77e9439f"], }, { next: (data) => console.log("Wallet Activity:", data), } ); // Unsubscribe from individual streams when needed unsubscribePairs(); unsubscribeTokens(); unsubscribeWallet(); // Or disconnect from all streams at once await client.StreamingService.disconnect(); [​](https://goldrush.dev/docs/goldrush-streaming-api/sdk#react-integration) React Integration ------------------------------------------------------------------------------------------------ For React applications, use the `useEffect` hook to properly manage subscription lifecycle: GoldRush SDK Copy Ask AI useEffect(() => { const unsubscribe = client.StreamingService.rawQuery( `subscription { ohlcvCandlesForPair( chain_name: BASE_MAINNET pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"], interval: StreamingInterval.ONE_MINUTE, timeframe: StreamingTimeframe.ONE_HOUR, ) { open high low close volume price_usd volume_usd chain_name pair_address interval timeframe timestamp } }`, {}, { next: (data) => console.log("Received streaming data:", data), error: (err) => console.error("Subscription error:", err), complete: () => console.info("Subscription completed"), } ); // Cleanup function - unsubscribe when component unmounts return () => { unsubscribe(); }; }, []); [​](https://goldrush.dev/docs/goldrush-streaming-api/sdk#graphql-queries) GraphQL Queries -------------------------------------------------------------------------------------------- You can also use raw GraphQL queries for more streamlined and selective data scenarios: GoldRush SDK Copy Ask AI const unsubscribeNewPairs = client.StreamingService.rawQuery( `subscription { newPairs( chain_name: BASE_MAINNET, protocols: [UNISWAP_V2, UNISWAP_V3] ) { chain_name protocol pair_address tx_hash liquidity base_token_metadata { contract_name contract_ticker_symbol } quote_token_metadata { contract_name contract_ticker_symbol } } }`, {}, { next: (data) => console.log("Raw new pairs data:", data), error: (error) => console.error("Error:", error), } ); // Raw query for token OHLCV data const unsubscribeTokenOHLCV = client.StreamingService.rawQuery( `subscription { ohlcvCandlesForToken( chain_name: BASE_MAINNET token_addresses: ["0x4B6104755AfB5Da4581B81C552DA3A25608c73B8"] interval: ONE_MINUTE timeframe: ONE_HOUR ) { open high low close volume volume_usd quote_rate quote_rate_usd timestamp base_token { contract_name contract_ticker_symbol } } }`, {}, { next: (data) => console.log("Raw token OHLCV data:", data), error: (error) => console.error("Error:", error), } ); [Authentication](https://goldrush.dev/docs/goldrush-streaming-api/authentication) [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/unified-api/quickstart/typescript-sdk#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Quickstart](https://goldrush.dev/docs/goldrush-foundational-api/quickstart#) [SDK Guide](https://goldrush.dev/docs/goldrush-streaming-api/sdk#sdk-guide) [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks#) ⌘I --- # Update Pairs Stream - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Available Streams Update Pairs Stream [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Parameters](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#parameters) * [Subscription](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#subscription) * [Basic Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#basic-subscription-query) * [Complete Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#complete-subscription-query) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#response-format) * [Field Descriptions](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#field-descriptions) The Update Pairs stream provides real-time updates on the prices, volumes, market cap and liquidity of **one or many token pairs**. This documentation follows our standard streaming API structure. Credit Cost ----------- TBD Supported Chains ---------------- * `BASE_MAINNET` * `BSC_MAINNET` * `ETH_MAINNET` * `SONIC_MAINNET` * `SOLANA_MAINNET` * `MONAD_MAINNET` **This stream is currently in Beta.** It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. **No API credits are currently charged.**We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#50232520203f222410333f26313c353e2438217e333f3d) to us directly to report issues or request features. [​](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#parameters) Parameters -------------------------------------------------------------------------------------------------- | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `chain_name` | `enum` | Yes | Chain name to filter events (e.g. `BASE_MAINNET`, `ETH_MAINNET`, `BSC_MAINNET`, `SOLANA_MAINNET`) | | `pair_addresses` | `array` | Yes | Array of pair addresses on [supported DEXes](https://goldrush.dev/docs/goldrush-streaming-api/overview#supported-chains-%26-dexes)
and chains to track | [​](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#subscription) Subscription ------------------------------------------------------------------------------------------------------ You can subscribe to the `updatePairs` endpoint to receive the events. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#basic-subscription-query) Basic Subscription Query Copy Ask AI subscription { updatePairs( chain_name: BASE_MAINNET pair_addresses: ["0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"] ) { chain_name pair_address timestamp quote_rate quote_rate_usd volume volume_usd market_cap liquidity } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#complete-subscription-query) Complete Subscription Query Copy Ask AI subscription { updatePairs( chain_name: BASE_MAINNET pair_addresses: [\ "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903"\ "0x4b0Aaf3EBb163dd45F663b38b6d93f6093EBC2d3"\ ] ) { chain_name pair_address timestamp quote_rate quote_rate_usd volume volume_usd market_cap liquidity base_token { contract_name contract_address contract_decimals contract_ticker_symbol } quote_token { contract_name contract_address contract_decimals contract_ticker_symbol } price_deltas { last_5m last_1hr last_6hr last_24hr } swap_counts { last_5m last_1hr last_6hr last_24hr } } } [​](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#response-format) Response Format ------------------------------------------------------------------------------------------------------------ Here’s an example of the response data structure: Copy Ask AI { "data": { "updatePairs": [\ {\ "chain_name": "BASE_MAINNET",\ "pair_address": "0x9c087Eb773291e50CF6c6a90ef0F4500e349B903",\ "quote_rate": 0.0002962,\ "quote_rate_usd": 1.39,\ "volume": 0.2079461510855417,\ "volume_usd": 975.515187,\ "quote_token": {\ "contract_name": "Wrapped Ether",\ "contract_symbol": "WETH",\ "contract_address": "0x4200000000000000000000000000000000000006",\ "contract_decimals": 18\ },\ "base_token": {\ "contract_name": "Virtual",\ "contract_symbol": "VIRTUAL",\ "contract_address": "0x0b3e328455c4059EEb9e3f84b5543F74E24e7E1b",\ "contract_decimals": 18\ },\ "swap_counts": {\ "last_5m": 10\ "last_1hr": 100\ "last_6hr": 1000\ "last_24hr": 10000\ },\ "price_deltas": {\ "last_5m": 1.2\ "last_1hr": 1.9\ "last_6hr": 2.7\ "last_24hr": -9.1\ }\ }\ ] } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#field-descriptions) Field Descriptions | Field | Type | Description | | --- | --- | --- | | `chain_name` | `string` | The blockchain network where the pair exists | | `pair_address` | `string` | The address of the DEX pair | | `quote_rate` | `float` | Quote rate of the token | | `quote_rate_usd` | `float` | Quote rate of the token in USD | | `volume` | `float` | Trading volume during the interval | | `volume_usd` | `float` | Trading volume in USD | | `base_token` | `object` | Information about the base token in the pair | | `quote_token` | `object` | Information about the quote token in the pair | | `swap_counts` | `object` | Swap counts for last 5m, 1hr, 6hr, 24hr | | `price_deltas` | `object` | Price deltas for last 5m, 1hr, 6hr, 24hr | [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) ⌘I --- # Get logs - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get logs [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getLogs({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "supports_erc": [\ ""\ ],\ "sender_logo_url": "",\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ] } GET / v1 / {chainName} / events Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getLogs({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "supports_erc": [\ ""\ ],\ "sender_logo_url": "",\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ] } Credit Cost ----------- 0.01 per item Processing ---------- Realtime Limits: * For a block range of 2,000 blocks or less, the response will include all logs within the range. * For a block range greater than 2,000 blocks:- The response will include up to 10,000 logs. * If the number of logs exceeds 10,000, no logs will be included in the response. Instead, the response will contain a suggested range within the `info` object, including a link and message. Related guides [How to Get the Latest Axie Spawns](https://goldrush.dev/guides/how-to-get-the-latest-axie-spawns) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#parameter-starting-block) starting-block integer The first block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#parameter-ending-block) ending-block string The last block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#parameter-address) address string The address of the log events sender contract. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#parameter-topics) topics string The topic hash(es) to retrieve logs with. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#parameter-block-hash) block-hash string The block hash to retrieve logs for. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#parameter-skip-decode) skip-decode boolean Omit decoded log events. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs#response-items) items object\[\] List of response items. Show child attributes [Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) [Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [Changelog](https://goldrush.dev/docs/changelog#streaming-api-launch) [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream#update-pairs-stream) [Overview](https://goldrush.dev/docs/goldrush-streaming-api/overview#) ⌘I --- # GoldRush Playground - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-playground#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Resources GoldRush Playground [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) [Decoded Events](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events) ⌘I --- # Decoded Events - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Resources Decoded Events [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Transfer Event](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#transfer-event) * [Swap Event](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#swap-event) * [Bridge Event](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#bridge-event) * [Deposit Event](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#deposit-event) * [Withdraw Event](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#withdraw-event) * [Approve Event](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#approve-event) * [Transaction Logs](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#transaction-logs) * [Error Details](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#error-details) The following events are decoded in the GoldRush Streaming API: * [Transfer](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#transfer-event) * [Swap](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#swap-event) * [Bridge](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#bridge-event) * [Deposit](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#deposit-event) * [Withdraw](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#withdraw-event) * [Approve](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#approve-event) [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#transfer-event) Transfer Event ----------------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `from` | `string` | The source address | | `to` | `string` | The destination address | | `amount` | `string` | Unscaled token amount (scale by `metadata.contract_decimals`) | | `quote_rate_usd` | `string` | Exchange rate of the token in USD | | `quote_usd` | `string` | The quote amount of the token in USD | | `contract_metadata` | `object` | Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol` | [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#swap-event) Swap Event --------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `token_in` | `string` | The input token address | | `token_out` | `string` | The output token address | | `amount_in` | `string` | The amount of input tokens | | `amount_out` | `string` | The amount of output tokens | [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#bridge-event) Bridge Event ------------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `type` | `string` | The bridge transaction type | | `typeString` | `string` | Human-readable bridge transaction type | | `from` | `string` | The source address | | `to` | `string` | The destination address | | `amount` | `string` | Unscaled token amount (scale by `metadata.contract_decimals`) | | `quote_rate_usd` | `string` | Exchange rate of the token in USD | | `quote_usd` | `string` | The quote amount of the token in USD | | `contract_metadata` | `object` | Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol` | [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#deposit-event) Deposit Event --------------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `from` | `string` | The source address | | `to` | `string` | The destination address | | `amount` | `string` | Unscaled token amount (scale by `metadata.contract_decimals`) | | `quote_rate_usd` | `string` | Exchange rate of the token in USD | | `quote_usd` | `string` | The quote amount of the token in USD | | `contract_metadata` | `object` | Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol` | [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#withdraw-event) Withdraw Event ----------------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `from` | `string` | The source address | | `to` | `string` | The destination address | | `amount` | `string` | Unscaled token amount (scale by `metadata.contract_decimals`) | | `quote_rate_usd` | `string` | Exchange rate of the token in USD | | `quote_usd` | `string` | The quote amount of the token in USD | | `contract_metadata` | `object` | Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol` | [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#approve-event) Approve Event --------------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `spender` | `string` | The address approved to spend tokens | | `amount` | `string` | Unscaled token amount (scale by `metadata.contract_decimals`) | | `quote_rate_usd` | `string` | Exchange rate of the token in USD | | `quote_usd` | `string` | The quote amount of the token in USD | | `contract_metadata` | `object` | Contract details including `contract_name`, `contract_address`, `contract_decimals`, and `contract_ticker_symbol` | [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#transaction-logs) Transaction Logs --------------------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `emitter_address` | `string` | The address that emitted the log | | `log_offset` | `integer` | The offset of the log in the transaction | | `data` | `string` | The raw log data | | `topics` | `array` | Array of log topics | [​](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#error-details) Error Details --------------------------------------------------------------------------------------------------- | Field | Type | Description | | --- | --- | --- | | `message` | `string` | Error message describing what went wrong | [GraphQL Endpoints](https://goldrush.dev/docs/goldrush-streaming-api/graphql-endpoints) [GoldRush Playground](https://goldrush.dev/docs/goldrush-playground) ⌘I --- # Wallet Activity Stream - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Available Streams Wallet Activity Stream [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Supported Actions](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#supported-actions) * [Parameters](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#parameters) * [Subscription](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#subscription) * [Basic Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#basic-subscription-query) * [Complete Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#complete-subscription-query) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#response-format) * [Field Descriptions](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#field-descriptions) * [Decoded Events](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#decoded-events) The Wallet Activity stream provides real-time updates on wallet **transactions, token transfers, and interactions with smart contracts** . This documentation follows our standard Streaming API structure. Credit Cost ----------- TBD Supported Chains ---------------- * `BASE_MAINNET` * `BASE_SEPOLIA` * `BASE_MAINNET_FLASHBLOCKS` * `BASE_SEPOLIA_FLASHBLOCKS` * `BSC_MAINNET` * `BSC_TESTNET` * `ETH_MAINNET` * `ETH_SEPOLIA` * `SONIC_MAINNET` * `HYPERCORE_MAINNET` * `MONAD_MAINNET` **This stream is currently in Beta.** It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. **No API credits are currently charged.**We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#5a292f2a2a35282e1a39352c3b363f342e322b74393537) to us directly to report issues or request features. [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#supported-actions) Supported Actions ------------------------------------------------------------------------------------------------------------------- All transactions are returned as raw data, but the following transaction types are decoded: * [Transfer](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#transfer-event) * [Swap](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#swap-event) * [Bridge](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#bridge-event) * [Deposit](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#deposit-event) * [Withdraw](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#withdraw-event) * [Approve](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events#approve-event) [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#parameters) Parameters ----------------------------------------------------------------------------------------------------- | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `chain_name` | `enum` | Yes | Chain name to filter events (e.g. `BASE_MAINNET`, `ETH_MAINNET`, `BSC_MAINNET`) | | `wallet_addresses` | `array` | Yes | Addresses to track | [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#subscription) Subscription --------------------------------------------------------------------------------------------------------- You can subscribe to the `walletTxs` endpoint to receive events. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#basic-subscription-query) Basic Subscription Query Copy Ask AI subscription { walletTxs( chain_name: BASE_MAINNET, wallet_addresses: [\ "0x4200000000000000000000000000000000000006",\ "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"\ ]) { block_signed_at block_height tx_hash tx_offset successful decoded_type } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#complete-subscription-query) Complete Subscription Query Copy Ask AI subscription { walletTxs( chain_name: BASE_MAINNET, wallet_addresses: [\ "0x198ef79f1f515f02dfe9e3115ed9fc07183f02fc",\ "0x4200000000000000000000000000000000000006"\ ] ) { tx_hash from_address to_address value chain_name block_signed_at block_height block_hash miner_address gas_used tx_offset successful decoded_type decoded_details { ... on TransferTransaction { from to amount quote_usd quote_rate_usd contract_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } } ... on SwapTransaction { token_in token_out amount_in amount_out } ... on BridgeTransaction { type typeString from to amount quote_usd quote_rate_usd contract_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } } ... on DepositTransaction { from to amount quote_usd quote_rate_usd contract_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } } ... on WithdrawTransaction { from to amount quote_usd quote_rate_usd contract_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } } ... on ApproveTransaction { spender amount quote_usd quote_rate_usd contract_metadata { contract_name contract_address contract_decimals contract_ticker_symbol } } ... on ErrorDetails { message } } logs { emitter_address log_offset data topics } } } [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#response-format) Response Format --------------------------------------------------------------------------------------------------------------- Here’s an example of the response data structure: Copy Ask AI { "data": { "walletTxs": [\ {\ "tx_hash": "0x23a4f9710c23678a8c6ae25d7e3aa75a82866231e9bd541114046c5a710a8355",\ "from_address": "0xd2216ed62a5c84f285a051839e808902fe8fc90b",\ "to_address": "0x198ef79f1f515f02dfe9e3115ed9fc07183f02fc",\ "value": 0,\ "chain_name": "base-mainnet",\ "block_signed_at": "2025-05-29T19:27:25Z",\ "block_height": 30878749,\ "block_hash": "0x2435aec7c20678ee82ae251ab1066e15ed3dac7ff0ea086c44ee8476a721abde",\ "miner_address": "0x4200000000000000000000000000000000000011",\ "gas_used": 195861,\ "tx_offset": 118,\ "successful": true,\ "decoded_type": "SWAP",\ "decoded": {\ "token_in": "0x4200000000000000000000000000000000000006",\ "amount_in": 1.157920892373162e+77,\ "token_out": "0x14b2f229097df3c92b43ea871860e3fae08d7f06",\ "amount_out": 1.0002764028751458e+23\ },\ "logs": [\ {\ "emitter": "0x4200000000000000000000000000000000000006",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x000000000000000000000000286f3add5dd41ba6e208f9f9a68533107fd0d0fa",\ "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc"\ ]\ },\ {\ "emitter": "0x14b2f229097df3c92b43ea871860e3fae08d7f06",\ "topics": [\ "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",\ "0x000000000000000000000000d2216ed62a5c84f285a051839e808902fe8fc90b",\ "0x000000000000000000000000286f3add5dd41ba6e208f9f9a68533107fd0d0fa"\ ]\ },\ {\ "emitter": "0x286f3add5dd41ba6e208f9f9a68533107fd0d0fa",\ "topics": [\ "0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67",\ "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc",\ "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc"\ ]\ },\ {\ "emitter": "0x4200000000000000000000000000000000000006",\ "topics": [\ "0x7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65",\ "0x000000000000000000000000198ef79f1f515f02dfe9e3115ed9fc07183f02fc"\ ]\ }\ ]\ }\ ] } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#field-descriptions) Field Descriptions | Field | Type | Description | | --- | --- | --- | | `tx_hash` | `string` | The transaction hash | | `from_address` | `string` | The sender’s address | | `to_address` | `string` | The recipient’s address | | `value` | `integer` | The transaction value in native currency | | `chain_name` | `string` | The blockchain network where the transaction occurred | | `block_signed_at` | `string` | ISO timestamp of when the block was signed | | `block_height` | `integer` | The block number where the transaction was included | | `block_hash` | `string` | The hash of the block containing the transaction | | `miner_address` | `string` | The address of the block miner | | `gas_used` | `integer` | The amount of gas used by the transaction | | `tx_offset` | `integer` | The position of the transaction in the block | | `successful` | `boolean` | Whether the transaction was successful | | `decoded_type` | `string` | The type of decoded event (e.g., “SWAP”) | | `decoded` | `object` | The decoded event data (varies by event type) | | `logs` | `array` | Array of event logs emitted during the transaction | [​](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#decoded-events) Decoded Events ------------------------------------------------------------------------------------------------------------- Note from the [Complete Subscription Query](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream#complete-subscription-query) , this stream decodes events which you can fetch with fragment spreads. See the full schema of available [decoded events](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events) . [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) [Get top trading wallets for token](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token) ⌘I --- # Get PnL for wallet - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Available Queries Get PnL for wallet [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Parameters](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#parameters) * [Query](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#query) * [Basic Query](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#basic-query) * [Complete Query](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#complete-query) * [Response Format](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#response-format) * [Field Descriptions](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#field-descriptions) * [GraphQL Playground](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#graphql-playground) This GraphQL query provides detailed financial metrics, including unrealized and realized profit and loss (PnL), current balance, and transaction insights for each token held by a specific wallet address. Credit Cost ----------- TBD Supported Chains ---------------- * Base Mainnet * BSC Mainnet * Ethereum Mainnet * Gnosis Mainnet * Polygon Mainnet * Optimism Mainnet **This query is currently in Beta.** It is stable for testing and evaluation but may undergo changes in schema or behavior as we continue to improve it. **No API credits are currently charged.**We welcome your feedback so please [reach out](https://goldrush.dev/cdn-cgi/l/email-protection#31424441415e434571525e47505d545f4559401f525e5c) to us directly to report issues or request features. [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#parameters) Parameters ---------------------------------------------------------------------------------------------- | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `chain_name` | `enum` | Yes | Chain name to filter events (e.g., `BASE_MAINNET`, `ETH_MAINNET`, `BSC_MAINNET`) | | `wallet_address` | `string` | Yes | The wallet address to query | [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#query) Query ------------------------------------------------------------------------------------ You can query the `upnlForWallet` endpoint to retrieve detailed PnL metrics for a wallet. ### [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#basic-query) Basic Query Copy Ask AI query { upnlForToken( chain_name: ETH_MAINNET wallet_address: "0xfe97b0C517a84F98fc6eDe3CD26B43012d31992a" ) { token cost_basis current_price pnl_realized_usd pnl_unrealized_usd net_balance_change } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#complete-query) Complete Query Copy Ask AI query{ upnlForWallet( chain_name:ETH_MAINNET, wallet_address:"0xfe97b0C517a84F98fc6eDe3CD26B43012d31992a" ) { token cost_basis current_price pnl_realized_usd pnl_unrealized_usd net_balance_change marketcap_usd contract_metadata { contract_address contract_name contract_ticker_symbol contract_decimals } } } [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#response-format) Response Format -------------------------------------------------------------------------------------------------------- Here’s an example of the response data structure: Copy Ask AI { "data": { "upnlForWallet": [\ {\ "token": "0x7abc8a5768e6be61a6c693a6e4eacb5b60602c4d",\ "cost_basis": 0.03219392,\ "current_price": 0.032418,\ "pnl_realized_usd": null,\ "pnl_unrealized_usd": 318.22842,\ "net_balance_change": 1420158,\ "marketcap_usd": "32418001.4431",\ "contract_metadata": {\ "contract_address": "0x7abc8a5768e6be61a6c693a6e4eacb5b60602c4d",\ "contract_name": "Covalent X Token",\ "contract_ticker_symbol": "CXT",\ "contract_decimals": 18\ }\ }\ ] } } ### [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#field-descriptions) Field Descriptions | Field | Type | Description | | --- | --- | --- | | `token` | `string` | Token contract address, represented in uppercase with a 0x prefix | | `cost_basis` | `float` | Simple Average cost basis per token in USD | | `current_price` | `float` | Current market price per token in USD | | `pnl_realized_usd` | `float` | Realized profit or loss in USD from completed trades | | `pnl_unrealized_usd` | `float` | Current unrealized profit or loss in USD based on the latest price | | `net_balance_change` | `BigInteger` | Net token movement (inflow minus outflow) over the past 7 days | | `marketcap_usd` | `string` | Token’s estimated market capitalization in USD | | `contract_metadata` | `object` | Contains metadata details for the token contract | [​](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet#graphql-playground) GraphQL Playground -------------------------------------------------------------------------------------------------------------- [Get top trading wallets for token](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-token) [GraphQL Endpoints](https://goldrush.dev/docs/goldrush-streaming-api/graphql-endpoints) ⌘I --- # GraphQL Endpoints - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/goldrush-streaming-api/graphql-endpoints#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Resources GraphQL Endpoints [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [List of endpoints](https://goldrush.dev/docs/goldrush-streaming-api/graphql-endpoints#list-of-endpoints) * [Fetching the schema](https://goldrush.dev/docs/goldrush-streaming-api/graphql-endpoints#fetching-the-schema) [​](https://goldrush.dev/docs/goldrush-streaming-api/graphql-endpoints#list-of-endpoints) List of endpoints -------------------------------------------------------------------------------------------------------------- | Functionality | Endpoint Type | | | --- | --- | --- | | New DEX Pairs Stream | `subscription` | `subscription { newPairs { ... } }` | | Wallet ActivityStream | `subscription` | `subscription { walletTxs { ... } }` | | OHLC Pairs Stream | `subscription` | `subscription { ohlcvCandlesForPair { ... } }` | | OHLC Tokens Stream | `subscription` | `subscription { ohlcvCandlesForToken { ... } }` | | Get top trading wallets for token | `query` | `query { upnlForToken { ... } }` | | Get PnL for wallet | `query` | `query { upnlForWallet { ... } }` | [​](https://goldrush.dev/docs/goldrush-streaming-api/graphql-endpoints#fetching-the-schema) Fetching the schema ------------------------------------------------------------------------------------------------------------------ Copy Ask AI query IntrospectionQuery { __schema { queryType { name } mutationType { name } subscriptionType { name } types { ...FullType } directives { name description locations args { ...InputValue } } } } fragment FullType on __Type { kind name description fields(includeDeprecated: true) { name description args { ...InputValue } type { ...TypeRef } isDeprecated deprecationReason } inputFields { ...InputValue } interfaces { ...TypeRef } enumValues(includeDeprecated: true) { name description isDeprecated deprecationReason } possibleTypes { ...TypeRef } } fragment InputValue on __InputValue { name description type { ...TypeRef } defaultValue } fragment TypeRef on __Type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } } } [Get PnL for wallet](https://goldrush.dev/docs/goldrush-streaming-api/upnl-for-wallet) [Decoded Events](https://goldrush.dev/docs/goldrush-streaming-api/decoded-events) ⌘I --- # Monad - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/monad#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Monad [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/monad#overview) * [Supported APIs](https://goldrush.dev/docs/chains/monad#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/monad#mainnet) * [Testnet](https://goldrush.dev/docs/chains/monad#testnet) * [API Usage](https://goldrush.dev/docs/chains/monad#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/monad#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/monad#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/monad#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/monad#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/monad#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/monad#pricing-api) * [Security API](https://goldrush.dev/docs/chains/monad#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/monad#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/monad#block-explorer-api) * [Streaming API Support](https://goldrush.dev/docs/chains/monad#streaming-api-support) * [Additional Resources](https://goldrush.dev/docs/chains/monad#additional-resources) [​](https://goldrush.dev/docs/chains/monad#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive Monad 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 Monad Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/monad#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [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](https://goldrush.dev/docs/goldrush-streaming-api) [​](https://goldrush.dev/docs/chains/monad#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `monad-mainnet` | | **Chain ID** | `143` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Monad Blockchain Explorer](https://monadexplorer.com/) | | **Official Website** | [Monad Website](https://www.monad.xyz/) | | **Native Gas Token** | MON | [​](https://goldrush.dev/docs/chains/monad#testnet) Testnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `monad-testnet` | | **Chain ID** | `10143` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Monad Blockchain Explorer](https://testnet.monadexplorer.com/) | | **Official Website** | [Monad Testnet Website](https://www.monad.xyz/) | | **Native Gas Token** | MON | [​](https://goldrush.dev/docs/chains/monad#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/monad#chain-name) Chain Name * `monad-mainnet` (mainnet) * `monad-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/monad#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Monad Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/monad-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/monad#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Monad Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "monad-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/monad#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/monad#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/monad#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/monad#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/monad#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/monad#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/monad#streaming-api-support) Streaming API Support ------------------------------------------------------------------------------------------ This chain supports the following GoldRush Streaming APIs: * [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) * [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) * [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) * [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) * [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) [​](https://goldrush.dev/docs/chains/monad#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Mantle](https://goldrush.dev/docs/chains/mantle) [Oasis Sapphire](https://goldrush.dev/docs/chains/oasis-sapphire) ⌘I --- # Plasma - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/plasma#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Plasma [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/plasma#overview) * [Supported APIs](https://goldrush.dev/docs/chains/plasma#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/plasma#mainnet) * [Testnet](https://goldrush.dev/docs/chains/plasma#testnet) * [API Usage](https://goldrush.dev/docs/chains/plasma#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/plasma#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/plasma#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/plasma#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/plasma#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/plasma#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/plasma#pricing-api) * [Security API](https://goldrush.dev/docs/chains/plasma#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/plasma#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/plasma#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/plasma#additional-resources) [​](https://goldrush.dev/docs/chains/plasma#overview) Overview ----------------------------------------------------------------- GoldRush offers the most comprehensive Plasma 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 Plasma Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/plasma#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/plasma#mainnet) Mainnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `plasma-mainnet` | | **Chain ID** | `9745` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Plasma Explorer](https://plasmascan.to/) | | **Official Website** | [Plasma Website](https://www.plasma.to/) | | **Native Gas Token** | XPL | [​](https://goldrush.dev/docs/chains/plasma#testnet) Testnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `plasma-testnet` | | **Chain ID** | `9746` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Plasma Testnet Explorer](https://testnet.plasmascan.to/) | | **Official Website** | [Plasma Testnet Website](https://www.plasma.to/) | | **Native Gas Token** | XPL | [​](https://goldrush.dev/docs/chains/plasma#api-usage) API Usage ------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/plasma#chain-name) Chain Name * `plasma-mainnet` (mainnet) * `plasma-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/plasma#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Plasma Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/plasma-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/plasma#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Plasma Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "plasma-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/plasma#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/plasma#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/plasma#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/plasma#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/plasma#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/plasma#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/plasma#additional-resources) Additional Resources ----------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Oasis Sapphire](https://goldrush.dev/docs/chains/oasis-sapphire) [Scroll](https://goldrush.dev/docs/chains/scroll) ⌘I --- # Bitcoin - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/bitcoin#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Bitcoin [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/bitcoin#overview) * [Mainnet](https://goldrush.dev/docs/chains/bitcoin#mainnet) * [API Usage](https://goldrush.dev/docs/chains/bitcoin#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/bitcoin#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/bitcoin#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/bitcoin#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/bitcoin#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/bitcoin#wallet-api) * [Activity Feed API](https://goldrush.dev/docs/chains/bitcoin#activity-feed-api) * [Additional Resources](https://goldrush.dev/docs/chains/bitcoin#additional-resources) [​](https://goldrush.dev/docs/chains/bitcoin#overview) Overview ------------------------------------------------------------------ GoldRush offers the most comprehensive Bitcoin 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 Bitcoin Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. [​](https://goldrush.dev/docs/chains/bitcoin#mainnet) Mainnet ---------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `btc-mainnet` | | **Chain ID** | `20090103` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://blockstream.info/) | | **Official Website** | [Bitcoin Website](https://bitcoin.org/en/) | | **Native Gas Token** | BTC | [​](https://goldrush.dev/docs/chains/bitcoin#api-usage) API Usage -------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/bitcoin#chain-name) Chain Name * `btc-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/bitcoin#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/btc-mainnet/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/bitcoin#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "btc-mainnet", walletAddress: "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo" }); [​](https://goldrush.dev/docs/chains/bitcoin#foundational-api-support) Foundational API Support -------------------------------------------------------------------------------------------------- This chain supports **3** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/bitcoin#wallet-api) Wallet API * **[Get Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address) ** * **[Get Bitcoin balances for HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address) ** #### [​](https://goldrush.dev/docs/chains/bitcoin#activity-feed-api) Activity Feed API * **[Get transactions for Bitcoin address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address) ** [​](https://goldrush.dev/docs/chains/bitcoin#additional-resources) Additional Resources ------------------------------------------------------------------------------------------ * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Gnosis](https://goldrush.dev/docs/chains/gnosis) [Avalanche C-Chain](https://goldrush.dev/docs/chains/avalanche-c-chain) ⌘I --- # HyperEVM - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/hyperevm#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains HyperEVM [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/hyperevm#overview) * [Supported APIs](https://goldrush.dev/docs/chains/hyperevm#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/hyperevm#mainnet) * [API Usage](https://goldrush.dev/docs/chains/hyperevm#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/hyperevm#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/hyperevm#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/hyperevm#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/hyperevm#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/hyperevm#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/hyperevm#pricing-api) * [Security API](https://goldrush.dev/docs/chains/hyperevm#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/hyperevm#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/hyperevm#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/hyperevm#additional-resources) [​](https://goldrush.dev/docs/chains/hyperevm#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive HyperEVM 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 HyperEVM Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/hyperevm#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/hyperevm#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `hyperevm-mainnet` | | **Chain ID** | `999` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [HyperEVM Explorer](https://hyperevmscan.io/) | | **Official Website** | [HyperEVM Website](https://hyperfoundation.org/) | | **Native Gas Token** | HYPE | [​](https://goldrush.dev/docs/chains/hyperevm#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/hyperevm#chain-name) Chain Name * `hyperevm-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/hyperevm#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/hyperevm-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/hyperevm#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "hyperevm-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/hyperevm#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/hyperevm#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/hyperevm#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/hyperevm#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/hyperevm#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/hyperevm#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/hyperevm#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [HyperCore](https://goldrush.dev/docs/chains/hypercore) [Ink](https://goldrush.dev/docs/chains/ink) ⌘I --- # Manta Pacific Testnet - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/manta-pacific#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Manta Pacific Testnet [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/manta-pacific#overview) * [Supported APIs](https://goldrush.dev/docs/chains/manta-pacific#supported-apis) * [Network Details](https://goldrush.dev/docs/chains/manta-pacific#network-details) * [Testnet](https://goldrush.dev/docs/chains/manta-pacific#testnet) * [API Usage](https://goldrush.dev/docs/chains/manta-pacific#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/manta-pacific#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/manta-pacific#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/manta-pacific#sdk-usage) * [Additional Resources](https://goldrush.dev/docs/chains/manta-pacific#additional-resources) [​](https://goldrush.dev/docs/chains/manta-pacific#overview) Overview ------------------------------------------------------------------------ GoldRush offers the most comprehensive Manta Pacific Testnet 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 Manta Pacific Testnet Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/manta-pacific#supported-apis) Supported APIs [​](https://goldrush.dev/docs/chains/manta-pacific#network-details) Network Details -------------------------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `manta-sepolia-testnet` | | **Chain ID** | `3441006` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://pacific-explorer.manta.network/) | | **Official Website** | [Manta Pacific Testnet Website](https://pacific-explorer.testnet.manta.network/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/manta-pacific#testnet) Testnet ---------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `manta-sepolia-testnet` | | **Chain ID** | `3441006` | | **Purpose** | Development and testing network | | **Support Level** | community | | **Block Explorer** | [Explorer](https://pacific-explorer.manta.network/) | | **Official Website** | [Manta Pacific Testnet Website](https://pacific-explorer.testnet.manta.network/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/manta-pacific#api-usage) API Usage -------------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/manta-pacific#chain-name) Chain Name * `manta-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/manta-pacific#example-api-calls) Example API Calls Chain Name Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/manta-sepolia-testnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/manta-pacific#sdk-usage) SDK Usage TypeScript SDK Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "manta-sepolia-testnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/manta-pacific#additional-resources) Additional Resources ------------------------------------------------------------------------------------------------ * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Oasis](https://goldrush.dev/docs/chains/oasis) [Moonbeam](https://goldrush.dev/docs/chains/moonbeam) ⌘I --- # Loot Chain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/loot-chain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Archived Chains Loot Chain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/loot-chain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/loot-chain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/loot-chain#mainnet) * [API Usage](https://goldrush.dev/docs/chains/loot-chain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/loot-chain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/loot-chain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/loot-chain#sdk-usage) * [Additional Resources](https://goldrush.dev/docs/chains/loot-chain#additional-resources) [​](https://goldrush.dev/docs/chains/loot-chain#overview) Overview --------------------------------------------------------------------- GoldRush offers the most comprehensive Loot Chain 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 Loot Chain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/loot-chain#supported-apis) Supported APIs [​](https://goldrush.dev/docs/chains/loot-chain#mainnet) Mainnet ------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `loot-mainnet` | | **Chain ID** | `5151706` | | **Network Type** | Archived Chain | | **Support Level** | archived | | **Block Explorer** | [Explorer](https://explorer.lootchain.com/) | | **Official Website** | [Loot Chain Website](https://lootchain.com/) | | **Native Gas Token** | AGLD | [​](https://goldrush.dev/docs/chains/loot-chain#api-usage) API Usage ----------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/loot-chain#chain-name) Chain Name * `loot-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/loot-chain#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/loot-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/loot-chain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "loot-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/loot-chain#additional-resources) Additional Resources --------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Lisk](https://goldrush.dev/docs/chains/lisk) ⌘I --- # HyperCore - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/hypercore#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains HyperCore [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/hypercore#overview) * [Supported APIs](https://goldrush.dev/docs/chains/hypercore#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/hypercore#mainnet) * [API Usage](https://goldrush.dev/docs/chains/hypercore#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/hypercore#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/hypercore#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/hypercore#sdk-usage) * [Streaming API Support](https://goldrush.dev/docs/chains/hypercore#streaming-api-support) * [Additional Resources](https://goldrush.dev/docs/chains/hypercore#additional-resources) [​](https://goldrush.dev/docs/chains/hypercore#overview) Overview -------------------------------------------------------------------- GoldRush offers the most comprehensive HyperCore 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 HyperCore Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/hypercore#supported-apis) Supported APIs [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](https://goldrush.dev/docs/goldrush-streaming-api) [​](https://goldrush.dev/docs/chains/hypercore#mainnet) Mainnet ------------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `hypercore-mainnet` | | **Chain ID** | `na` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Hyperliquid Explorer](https://app.hyperliquid.xyz/explorer) | | **Official Website** | [HyperCore Website](https://hyperfoundation.org/) | | **Native Gas Token** | HYPE | [​](https://goldrush.dev/docs/chains/hypercore#api-usage) API Usage ---------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/hypercore#chain-name) Chain Name * `hypercore-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/hypercore#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/hypercore-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/hypercore#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "hypercore-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/hypercore#streaming-api-support) Streaming API Support ---------------------------------------------------------------------------------------------- This chain supports the following GoldRush Streaming APIs: * [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) * [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) [​](https://goldrush.dev/docs/chains/hypercore#additional-resources) Additional Resources -------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Berachain](https://goldrush.dev/docs/chains/berachain) [HyperEVM](https://goldrush.dev/docs/chains/hyperevm) ⌘I --- # Cronos - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/cronos#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Archived Chains Cronos [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/cronos#overview) * [Supported APIs](https://goldrush.dev/docs/chains/cronos#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/cronos#mainnet) * [API Usage](https://goldrush.dev/docs/chains/cronos#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/cronos#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/cronos#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/cronos#sdk-usage) * [Additional Resources](https://goldrush.dev/docs/chains/cronos#additional-resources) [​](https://goldrush.dev/docs/chains/cronos#overview) Overview ----------------------------------------------------------------- GoldRush offers the most comprehensive Cronos 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 Cronos Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/cronos#supported-apis) Supported APIs [​](https://goldrush.dev/docs/chains/cronos#mainnet) Mainnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `cronos-mainnet` | | **Chain ID** | `25` | | **Network Type** | Archived Chain | | **Support Level** | archived | | **Block Explorer** | [Explorer](https://cronoscan.com/) | | **Official Website** | [Cronos Website](https://cronos.org/) | | **Native Gas Token** | CRO | [​](https://goldrush.dev/docs/chains/cronos#api-usage) API Usage ------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/cronos#chain-name) Chain Name * `cronos-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/cronos#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/cronos-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/cronos#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "cronos-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/cronos#additional-resources) Additional Resources ----------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [ZetaChain](https://goldrush.dev/docs/chains/zetachain) [Harmony](https://goldrush.dev/docs/chains/harmony) ⌘I --- # Harmony - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/harmony#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Archived Chains Harmony [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/harmony#overview) * [Supported APIs](https://goldrush.dev/docs/chains/harmony#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/harmony#mainnet) * [Testnet](https://goldrush.dev/docs/chains/harmony#testnet) * [API Usage](https://goldrush.dev/docs/chains/harmony#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/harmony#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/harmony#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/harmony#sdk-usage) * [Additional Resources](https://goldrush.dev/docs/chains/harmony#additional-resources) [​](https://goldrush.dev/docs/chains/harmony#overview) Overview ------------------------------------------------------------------ GoldRush offers the most comprehensive Harmony 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 Harmony Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/harmony#supported-apis) Supported APIs [​](https://goldrush.dev/docs/chains/harmony#mainnet) Mainnet ---------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `harmony-mainnet` | | **Chain ID** | `1666600000` | | **Network Type** | Archived Chain | | **Support Level** | archived | | **Block Explorer** | [Explorer](https://explorer.harmony.one/) | | **Official Website** | [Harmony Website](https://www.harmony.one/) | | **Native Gas Token** | ONE | [​](https://goldrush.dev/docs/chains/harmony#testnet) Testnet ---------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `harmony-testnet` | | **Chain ID** | `1666700000` | | **Purpose** | Development and testing network | | **Support Level** | archived | | **Block Explorer** | [Explorer](https://explorer.testnet.harmony.one/) | | **Official Website** | [Harmony Testnet Website](https://www.harmony.one/) | | **Native Gas Token** | ONE | [​](https://goldrush.dev/docs/chains/harmony#api-usage) API Usage -------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/harmony#chain-name) Chain Name * `harmony-mainnet` (mainnet) * `harmony-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/harmony#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Harmony Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/harmony-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/harmony#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Harmony Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "harmony-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/harmony#additional-resources) Additional Resources ------------------------------------------------------------------------------------------ * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Cronos](https://goldrush.dev/docs/chains/cronos) [Lisk](https://goldrush.dev/docs/chains/lisk) ⌘I --- # Sonic - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/sonic#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Sonic [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/sonic#overview) * [Supported APIs](https://goldrush.dev/docs/chains/sonic#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/sonic#mainnet) * [API Usage](https://goldrush.dev/docs/chains/sonic#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/sonic#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/sonic#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/sonic#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/sonic#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/sonic#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/sonic#pricing-api) * [Security API](https://goldrush.dev/docs/chains/sonic#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/sonic#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/sonic#block-explorer-api) * [Streaming API Support](https://goldrush.dev/docs/chains/sonic#streaming-api-support) * [Additional Resources](https://goldrush.dev/docs/chains/sonic#additional-resources) [​](https://goldrush.dev/docs/chains/sonic#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive Sonic 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 Sonic Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/sonic#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [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](https://goldrush.dev/docs/goldrush-streaming-api) [​](https://goldrush.dev/docs/chains/sonic#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `sonic-mainnet` | | **Chain ID** | `146` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Sonic Explorer](https://sonicscan.org/) | | **Official Website** | [Sonic Website](https://www.soniclabs.com/) | | **Native Gas Token** | S | [​](https://goldrush.dev/docs/chains/sonic#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/sonic#chain-name) Chain Name * `sonic-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/sonic#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/sonic-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/sonic#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "sonic-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/sonic#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/sonic#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/sonic#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/sonic#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/sonic#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/sonic#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/sonic#streaming-api-support) Streaming API Support ------------------------------------------------------------------------------------------ This chain supports the following GoldRush Streaming APIs: * [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) * [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) * [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) * [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) * [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) [​](https://goldrush.dev/docs/chains/sonic#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Solana](https://goldrush.dev/docs/chains/solana) [Taiko](https://goldrush.dev/docs/chains/taiko) ⌘I --- # Solana - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/solana#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Solana [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/solana#overview) * [Supported APIs](https://goldrush.dev/docs/chains/solana#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/solana#mainnet) * [API Usage](https://goldrush.dev/docs/chains/solana#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/solana#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/solana#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/solana#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/solana#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/solana#wallet-api) * [Streaming API Support](https://goldrush.dev/docs/chains/solana#streaming-api-support) * [Additional Resources](https://goldrush.dev/docs/chains/solana#additional-resources) [​](https://goldrush.dev/docs/chains/solana#overview) Overview ----------------------------------------------------------------- GoldRush offers the most comprehensive Solana 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 Solana Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/solana#supported-apis) Supported APIs [Foundational API\ ----------------\ \ Access structured spot data such as token balances.Use cases: Wallets, portfolio trackers\ \ Read docs](https://goldrush.dev/docs/goldrush-foundational-api) [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](https://goldrush.dev/docs/goldrush-streaming-api) [​](https://goldrush.dev/docs/chains/solana#mainnet) Mainnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `solana-mainnet` | | **Chain ID** | `1399811149` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://explorer.solana.com/) | | **Official Website** | [Solana Website](https://solana.com/) | | **Native Gas Token** | SOL | [​](https://goldrush.dev/docs/chains/solana#api-usage) API Usage ------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/solana#chain-name) Chain Name * `solana-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/solana#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/solana-mainnet/address/4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/solana#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "solana-mainnet", walletAddress: "4ZJhPQAgUseCsWhKvJLTmmRRUV74fdoTpQLNfKoekbPY" }); [​](https://goldrush.dev/docs/chains/solana#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------- This chain supports **1** GoldRush Foundational API: #### [​](https://goldrush.dev/docs/chains/solana#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** [​](https://goldrush.dev/docs/chains/solana#streaming-api-support) Streaming API Support ------------------------------------------------------------------------------------------- This chain supports the following GoldRush Streaming APIs: * [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) * [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) * [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) * [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) [​](https://goldrush.dev/docs/chains/solana#additional-resources) Additional Resources ----------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Sei](https://goldrush.dev/docs/chains/sei) [Sonic](https://goldrush.dev/docs/chains/sonic) ⌘I --- # Lisk - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/lisk#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Archived Chains Lisk [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/lisk#overview) * [Supported APIs](https://goldrush.dev/docs/chains/lisk#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/lisk#mainnet) * [Testnet](https://goldrush.dev/docs/chains/lisk#testnet) * [API Usage](https://goldrush.dev/docs/chains/lisk#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/lisk#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/lisk#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/lisk#sdk-usage) * [Additional Resources](https://goldrush.dev/docs/chains/lisk#additional-resources) [​](https://goldrush.dev/docs/chains/lisk#overview) Overview --------------------------------------------------------------- GoldRush offers the most comprehensive Lisk 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 Lisk Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/lisk#supported-apis) Supported APIs [​](https://goldrush.dev/docs/chains/lisk#mainnet) Mainnet ------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `lisk-mainnet` | | **Chain ID** | `1135` | | **Network Type** | Archived Chain | | **Support Level** | archived | | **Block Explorer** | [Explorer](https://blockscout.lisk.com/) | | **Official Website** | [Lisk Website](https://lisk.com/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/lisk#testnet) Testnet ------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `lisk-sepolia-testnet` | | **Chain ID** | `4202` | | **Purpose** | Development and testing network | | **Support Level** | archived | | **Block Explorer** | [Explorer](https://sepolia-blockscout.lisk.com/) | | **Official Website** | [Lisk Sepolia Testnet Website](https://documentation.lisk.com/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/lisk#api-usage) API Usage ----------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/lisk#chain-name) Chain Name * `lisk-mainnet` (mainnet) * `lisk-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/lisk#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Lisk Sepolia Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/lisk-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/lisk#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Lisk Sepolia Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "lisk-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/lisk#additional-resources) Additional Resources --------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Harmony](https://goldrush.dev/docs/chains/harmony) [Loot Chain](https://goldrush.dev/docs/chains/loot-chain) ⌘I --- # Optimism - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/optimism#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Foundational Chains Optimism [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/optimism#overview) * [Supported APIs](https://goldrush.dev/docs/chains/optimism#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/optimism#mainnet) * [Testnet](https://goldrush.dev/docs/chains/optimism#testnet) * [API Usage](https://goldrush.dev/docs/chains/optimism#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/optimism#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/optimism#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/optimism#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/optimism#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/optimism#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/optimism#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/optimism#pricing-api) * [Security API](https://goldrush.dev/docs/chains/optimism#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/optimism#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/optimism#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/optimism#additional-resources) [​](https://goldrush.dev/docs/chains/optimism#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive Optimism 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 Optimism Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/optimism#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/optimism#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `optimism-mainnet` | | **Chain ID** | `10` | | **Network Type** | Foundational Chain | | **Support Level** | foundational | | **Block Explorer** | [Optimistic Etherscan](https://optimistic.etherscan.io/) | | **Official Website** | [Optimism Website](https://www.optimism.io/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/optimism#testnet) Testnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `optimism-sepolia` | | **Chain ID** | `11155420` | | **Purpose** | Development and testing network | | **Support Level** | foundational | | **Block Explorer** | [OP Sepolia Explorer](https://optimism-sepolia.blockscout.com/) | | **Official Website** | [Optimism Sepolia Testnet Website](https://community.optimism.io/docs/useful-tools/networks/#parameters-for-node-operators-2) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/optimism#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/optimism#chain-name) Chain Name * `optimism-mainnet` (mainnet) * `optimism-sepolia` (testnet) #### [​](https://goldrush.dev/docs/chains/optimism#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Optimism Sepolia Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/optimism-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/optimism#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Optimism Sepolia Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "optimism-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/optimism#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **28** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/optimism#wallet-api) Wallet API * **[Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) ** * **[Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) ** * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/optimism#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** * **[Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) ** * **[Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) ** #### [​](https://goldrush.dev/docs/chains/optimism#pricing-api) Pricing API * **[Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) ** * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/optimism#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/optimism#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/optimism#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/optimism#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [BNB Smart Chain (BSC)](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc) [Base](https://goldrush.dev/docs/chains/base) ⌘I --- # Polygon - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/polygon#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Foundational Chains Polygon [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/polygon#overview) * [Supported APIs](https://goldrush.dev/docs/chains/polygon#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/polygon#mainnet) * [Testnet](https://goldrush.dev/docs/chains/polygon#testnet) * [API Usage](https://goldrush.dev/docs/chains/polygon#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/polygon#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/polygon#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/polygon#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/polygon#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/polygon#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/polygon#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/polygon#pricing-api) * [Security API](https://goldrush.dev/docs/chains/polygon#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/polygon#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/polygon#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/polygon#additional-resources) [​](https://goldrush.dev/docs/chains/polygon#overview) 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. ### [​](https://goldrush.dev/docs/chains/polygon#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/polygon#mainnet) Mainnet ---------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `matic-mainnet` | | **Chain ID** | `137` | | **Network Type** | Foundational Chain | | **Support Level** | foundational | | **Block Explorer** | [PolygonScan](https://polygonscan.com/) | | **Official Website** | [Polygon Website](https://polygon.technology/) | | **Native Gas Token** | MATIC | [​](https://goldrush.dev/docs/chains/polygon#testnet) Testnet ---------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `polygon-amoy-testnet` | | **Chain ID** | `80002` | | **Purpose** | Development and testing network | | **Support Level** | foundational | | **Block Explorer** | [Amoy PolygonScan](https://amoy.polygonscan.com/) | | **Official Website** | [Polygon Amoy Testnet Website](https://polygon.technology/blog/introducing-the-amoy-testnet-for-polygon-pos) | | **Native Gas Token** | gwei | [​](https://goldrush.dev/docs/chains/polygon#api-usage) API Usage -------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/polygon#chain-name) Chain Name * `matic-mainnet` (mainnet) * `polygon-amoy-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/polygon#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Polygon Amoy Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/matic-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/polygon#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Polygon Amoy Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "matic-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/polygon#foundational-api-support) Foundational API Support -------------------------------------------------------------------------------------------------- This chain supports **28** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/polygon#wallet-api) Wallet API * **[Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) ** * **[Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) ** * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/polygon#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** * **[Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) ** * **[Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) ** #### [​](https://goldrush.dev/docs/chains/polygon#pricing-api) Pricing API * **[Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) ** * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/polygon#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/polygon#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/polygon#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/polygon#additional-resources) Additional Resources ------------------------------------------------------------------------------------------ * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Ethereum](https://goldrush.dev/docs/chains/ethereum) [BNB Smart Chain (BSC)](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc) ⌘I --- # Ethereum - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/ethereum#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Foundational Chains Ethereum [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/ethereum#overview) * [Supported APIs](https://goldrush.dev/docs/chains/ethereum#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/ethereum#mainnet) * [Testnets](https://goldrush.dev/docs/chains/ethereum#testnets) * [Holesky Testnet](https://goldrush.dev/docs/chains/ethereum#holesky-testnet) * [Ethereum Sepolia Testnet](https://goldrush.dev/docs/chains/ethereum#ethereum-sepolia-testnet) * [API Usage](https://goldrush.dev/docs/chains/ethereum#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/ethereum#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/ethereum#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/ethereum#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/ethereum#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/ethereum#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/ethereum#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/ethereum#pricing-api) * [Security API](https://goldrush.dev/docs/chains/ethereum#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/ethereum#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/ethereum#block-explorer-api) * [Streaming API Support](https://goldrush.dev/docs/chains/ethereum#streaming-api-support) * [Additional Resources](https://goldrush.dev/docs/chains/ethereum#additional-resources) [​](https://goldrush.dev/docs/chains/ethereum#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive Ethereum 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 Ethereum Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/ethereum#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [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](https://goldrush.dev/docs/goldrush-streaming-api) [​](https://goldrush.dev/docs/chains/ethereum#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `eth-mainnet` | | **Chain ID** | `1` | | **Network Type** | Foundational Chain | | **Support Level** | foundational | | **Block Explorer** | [Etherscan](https://etherscan.io/) | | **Official Website** | [Ethereum Website](https://ethereum.org/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/ethereum#testnets) Testnets ------------------------------------------------------------------- ### [​](https://goldrush.dev/docs/chains/ethereum#holesky-testnet) Holesky Testnet | **Property** | **Value** | | --- | --- | | **Chain Name** | `eth-holesky` | | **Chain ID** | `17000` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Holesky Etherscan](https://holesky.etherscan.io/) | | **Official Website** | [Holesky Testnet Website](https://github.com/eth-clients/holesky) | | **Native Gas Token** | ETH | ### [​](https://goldrush.dev/docs/chains/ethereum#ethereum-sepolia-testnet) Ethereum Sepolia Testnet | **Property** | **Value** | | --- | --- | | **Chain Name** | `eth-sepolia` | | **Chain ID** | `11155111` | | **Purpose** | Development and testing network | | **Support Level** | foundational | | **Block Explorer** | [Sepolia Etherscan](https://sepolia.etherscan.io/) | | **Official Website** | [Ethereum Sepolia Testnet Website](https://ethereum.org/en/developers/docs/networks/#ethereum-testnets) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/ethereum#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/ethereum#chain-name) Chain Name * `eth-mainnet` (mainnet) * `eth-holesky` (testnet) * `eth-sepolia` (testnet) #### [​](https://goldrush.dev/docs/chains/ethereum#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Holesky Testnet) Chain Name (Ethereum Sepolia Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/ethereum#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Holesky Testnet) TypeScript SDK (Ethereum Sepolia Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "eth-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/ethereum#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **28** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/ethereum#wallet-api) Wallet API * **[Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) ** * **[Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) ** * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/ethereum#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** * **[Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) ** * **[Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) ** #### [​](https://goldrush.dev/docs/chains/ethereum#pricing-api) Pricing API * **[Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) ** * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/ethereum#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/ethereum#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/ethereum#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/ethereum#streaming-api-support) Streaming API Support --------------------------------------------------------------------------------------------- This chain supports the following GoldRush Streaming APIs: * [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) * [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) * [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) * [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) * [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) [​](https://goldrush.dev/docs/chains/ethereum#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Supported Chains](https://goldrush.dev/docs/chains/overview) [Polygon](https://goldrush.dev/docs/chains/polygon) ⌘I --- # BNB Smart Chain (BSC) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Foundational Chains BNB Smart Chain (BSC) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#overview) * [Supported APIs](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#mainnet) * [Testnet](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#testnet) * [API Usage](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#pricing-api) * [Security API](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#block-explorer-api) * [Streaming API Support](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#streaming-api-support) * [Additional Resources](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#additional-resources) [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#overview) Overview ------------------------------------------------------------------------------ GoldRush offers the most comprehensive BNB Smart Chain (BSC) 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 BNB Smart Chain (BSC) Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [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](https://goldrush.dev/docs/goldrush-streaming-api) [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#mainnet) Mainnet ---------------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `bsc-mainnet` | | **Chain ID** | `56` | | **Network Type** | Foundational Chain | | **Support Level** | foundational | | **Block Explorer** | [BscScan](https://bscscan.com/) | | **Official Website** | [BNB Smart Chain (BSC) Website](https://www.bnbchain.org/en) | | **Native Gas Token** | BNB | [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#testnet) Testnet ---------------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `bsc-testnet` | | **Chain ID** | `97` | | **Purpose** | Development and testing network | | **Support Level** | foundational | | **Block Explorer** | [Bsc Testnet Scan](https://testnet.bscscan.com/) | | **Native Gas Token** | gwei | [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#api-usage) API Usage -------------------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#chain-name) Chain Name * `bsc-mainnet` (mainnet) * `bsc-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (BNB Smart Chain (BSC) Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/bsc-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (BNB Smart Chain (BSC) Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "bsc-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#foundational-api-support) Foundational API Support -------------------------------------------------------------------------------------------------------------- This chain supports **28** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#wallet-api) Wallet API * **[Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) ** * **[Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) ** * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** * **[Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) ** * **[Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) ** #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#pricing-api) Pricing API * **[Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) ** * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#streaming-api-support) Streaming API Support -------------------------------------------------------------------------------------------------------- This chain supports the following GoldRush Streaming APIs: * [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) * [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) * [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) * [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) * [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) [​](https://goldrush.dev/docs/chains/bnb-smart-chain-bsc#additional-resources) Additional Resources ------------------------------------------------------------------------------------------------------ * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Polygon](https://goldrush.dev/docs/chains/polygon) [Optimism](https://goldrush.dev/docs/chains/optimism) ⌘I --- # Avalanche C-Chain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/avalanche-c-chain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Avalanche C-Chain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/avalanche-c-chain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/avalanche-c-chain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/avalanche-c-chain#mainnet) * [Testnet](https://goldrush.dev/docs/chains/avalanche-c-chain#testnet) * [API Usage](https://goldrush.dev/docs/chains/avalanche-c-chain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/avalanche-c-chain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/avalanche-c-chain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/avalanche-c-chain#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/avalanche-c-chain#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/avalanche-c-chain#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/avalanche-c-chain#pricing-api) * [Security API](https://goldrush.dev/docs/chains/avalanche-c-chain#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/avalanche-c-chain#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/avalanche-c-chain#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/avalanche-c-chain#additional-resources) [​](https://goldrush.dev/docs/chains/avalanche-c-chain#overview) Overview ---------------------------------------------------------------------------- GoldRush offers the most comprehensive Avalanche C-Chain 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 Avalanche C-Chain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/avalanche-c-chain#mainnet) Mainnet -------------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `avalanche-mainnet` | | **Chain ID** | `43114` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://avascan.info/blockchain/c/) | | **Official Website** | [Avalanche C-Chain Website](https://www.avax.network/) | | **Native Gas Token** | AVAX | [​](https://goldrush.dev/docs/chains/avalanche-c-chain#testnet) Testnet -------------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `avalanche-testnet` | | **Chain ID** | `43113` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://testnet.avascan.info/) | | **Native Gas Token** | AVAX | [​](https://goldrush.dev/docs/chains/avalanche-c-chain#api-usage) API Usage ------------------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#chain-name) Chain Name * `avalanche-mainnet` (mainnet) * `avalanche-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Avalanche Fuji Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/avalanche-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Avalanche Fuji Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "avalanche-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/avalanche-c-chain#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/avalanche-c-chain#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/avalanche-c-chain#additional-resources) Additional Resources ---------------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Bitcoin](https://goldrush.dev/docs/chains/bitcoin) [ADI Chain](https://goldrush.dev/docs/chains/adi-chain) ⌘I --- # Arbitrum - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/arbitrum#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Arbitrum [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/arbitrum#overview) * [Supported APIs](https://goldrush.dev/docs/chains/arbitrum#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/arbitrum#mainnet) * [Testnet](https://goldrush.dev/docs/chains/arbitrum#testnet) * [API Usage](https://goldrush.dev/docs/chains/arbitrum#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/arbitrum#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/arbitrum#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/arbitrum#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/arbitrum#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/arbitrum#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/arbitrum#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/arbitrum#pricing-api) * [Security API](https://goldrush.dev/docs/chains/arbitrum#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/arbitrum#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/arbitrum#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/arbitrum#additional-resources) [​](https://goldrush.dev/docs/chains/arbitrum#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive Arbitrum 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 Arbitrum Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/arbitrum#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/arbitrum#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `arbitrum-mainnet` | | **Chain ID** | `42161` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Arbiscan](https://arbiscan.io/) | | **Official Website** | [Arbitrum Website](https://arbitrum.io/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/arbitrum#testnet) Testnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `arbitrum-sepolia` | | **Chain ID** | `421614` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Sepolia Arbiscan](https://sepolia.arbiscan.io/) | | **Official Website** | [Arbitrum Sepolia Testnet Website](https://docs.arbitrum.io/for-devs/concepts/public-chains#arbitrum-sepolia) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/arbitrum#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/arbitrum#chain-name) Chain Name * `arbitrum-mainnet` (mainnet) * `arbitrum-sepolia` (testnet) #### [​](https://goldrush.dev/docs/chains/arbitrum#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Arbitrum Sepolia Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/arbitrum-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/arbitrum#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Arbitrum Sepolia Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "arbitrum-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/arbitrum#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **23** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/arbitrum#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/arbitrum#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** #### [​](https://goldrush.dev/docs/chains/arbitrum#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/arbitrum#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/arbitrum#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/arbitrum#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/arbitrum#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [ApeChain](https://goldrush.dev/docs/chains/apechain) [Arbitrum Nova](https://goldrush.dev/docs/chains/arbitrum-nova) ⌘I --- # Axie/Ronin - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/axie-ronin#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Axie/Ronin [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/axie-ronin#overview) * [Supported APIs](https://goldrush.dev/docs/chains/axie-ronin#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/axie-ronin#mainnet) * [API Usage](https://goldrush.dev/docs/chains/axie-ronin#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/axie-ronin#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/axie-ronin#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/axie-ronin#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/axie-ronin#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/axie-ronin#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/axie-ronin#pricing-api) * [Security API](https://goldrush.dev/docs/chains/axie-ronin#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/axie-ronin#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/axie-ronin#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/axie-ronin#additional-resources) [​](https://goldrush.dev/docs/chains/axie-ronin#overview) Overview --------------------------------------------------------------------- GoldRush offers the most comprehensive Axie/Ronin 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 Axie/Ronin Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/axie-ronin#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/axie-ronin#mainnet) Mainnet ------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `axie-mainnet` | | **Chain ID** | `2020` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://explorer.roninchain.com/) | | **Official Website** | [Axie/Ronin Website](https://www.skymavis.com/products) | | **Native Gas Token** | RON | [​](https://goldrush.dev/docs/chains/axie-ronin#api-usage) API Usage ----------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/axie-ronin#chain-name) Chain Name * `axie-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/axie-ronin#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/axie-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/axie-ronin#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "axie-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/axie-ronin#foundational-api-support) Foundational API Support ----------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/axie-ronin#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/axie-ronin#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/axie-ronin#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/axie-ronin#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/axie-ronin#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/axie-ronin#additional-resources) Additional Resources --------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Arc Testnet](https://goldrush.dev/docs/chains/arc) [Berachain](https://goldrush.dev/docs/chains/berachain) ⌘I --- # Gnosis - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/gnosis#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Foundational Chains Gnosis [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/gnosis#overview) * [Supported APIs](https://goldrush.dev/docs/chains/gnosis#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/gnosis#mainnet) * [Testnet](https://goldrush.dev/docs/chains/gnosis#testnet) * [API Usage](https://goldrush.dev/docs/chains/gnosis#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/gnosis#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/gnosis#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/gnosis#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/gnosis#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/gnosis#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/gnosis#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/gnosis#pricing-api) * [Security API](https://goldrush.dev/docs/chains/gnosis#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/gnosis#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/gnosis#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/gnosis#additional-resources) [​](https://goldrush.dev/docs/chains/gnosis#overview) Overview ----------------------------------------------------------------- GoldRush offers the most comprehensive Gnosis 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 Gnosis Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/gnosis#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/gnosis#mainnet) Mainnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `gnosis-mainnet` | | **Chain ID** | `100` | | **Network Type** | Foundational Chain | | **Support Level** | foundational | | **Block Explorer** | [Gnosis Blockscout](https://gnosis.blockscout.com/) | | **Official Website** | [Gnosis Website](https://docs.gnosischain.com/) | | **Native Gas Token** | xDAI | [​](https://goldrush.dev/docs/chains/gnosis#testnet) Testnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `gnosis-testnet` | | **Chain ID** | `10200` | | **Purpose** | Development and testing network | | **Support Level** | foundational | | **Block Explorer** | [Gnosis Chiado Blockscout](https://gnosis-chiado.blockscout.com/) | | **Official Website** | [Chiado Testnet Website](https://docs.gnosischain.com/about/networks/chiado) | | **Native Gas Token** | xDAI | [​](https://goldrush.dev/docs/chains/gnosis#api-usage) API Usage ------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/gnosis#chain-name) Chain Name * `gnosis-mainnet` (mainnet) * `gnosis-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/gnosis#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Chiado Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/gnosis-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/gnosis#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Chiado Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "gnosis-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/gnosis#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------- This chain supports **28** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/gnosis#wallet-api) Wallet API * **[Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) ** * **[Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) ** * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/gnosis#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** * **[Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) ** * **[Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) ** #### [​](https://goldrush.dev/docs/chains/gnosis#pricing-api) Pricing API * **[Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) ** * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/gnosis#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/gnosis#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/gnosis#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/gnosis#additional-resources) Additional Resources ----------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Base](https://goldrush.dev/docs/chains/base) [Bitcoin](https://goldrush.dev/docs/chains/bitcoin) ⌘I --- # Berachain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/berachain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Berachain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/berachain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/berachain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/berachain#mainnet) * [Testnet](https://goldrush.dev/docs/chains/berachain#testnet) * [API Usage](https://goldrush.dev/docs/chains/berachain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/berachain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/berachain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/berachain#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/berachain#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/berachain#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/berachain#pricing-api) * [Security API](https://goldrush.dev/docs/chains/berachain#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/berachain#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/berachain#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/berachain#additional-resources) [​](https://goldrush.dev/docs/chains/berachain#overview) Overview -------------------------------------------------------------------- GoldRush offers the most comprehensive Berachain 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 Berachain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/berachain#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/berachain#mainnet) Mainnet ------------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `berachain-mainnet` | | **Chain ID** | `80094` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Berachain Explorer](https://berascan.com/) | | **Official Website** | [Berachain Website](https://www.berachain.com/) | | **Native Gas Token** | BERA | [​](https://goldrush.dev/docs/chains/berachain#testnet) Testnet ------------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `berachain-testnet` | | **Chain ID** | `80084` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://bartio.beratrail.io/) | | **Official Website** | [Berachain Testnet Website](https://www.berachain.com/) | | **Native Gas Token** | BERA | [​](https://goldrush.dev/docs/chains/berachain#api-usage) API Usage ---------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/berachain#chain-name) Chain Name * `berachain-mainnet` (mainnet) * `berachain-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/berachain#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Berachain Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/berachain-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/berachain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Berachain Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "berachain-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/berachain#foundational-api-support) Foundational API Support ---------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/berachain#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/berachain#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/berachain#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/berachain#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/berachain#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/berachain#additional-resources) Additional Resources -------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Axie/Ronin](https://goldrush.dev/docs/chains/axie-ronin) [HyperCore](https://goldrush.dev/docs/chains/hypercore) ⌘I --- # ApeChain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/apechain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains ApeChain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/apechain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/apechain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/apechain#mainnet) * [API Usage](https://goldrush.dev/docs/chains/apechain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/apechain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/apechain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/apechain#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/apechain#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/apechain#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/apechain#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/apechain#pricing-api) * [Security API](https://goldrush.dev/docs/chains/apechain#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/apechain#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/apechain#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/apechain#additional-resources) [​](https://goldrush.dev/docs/chains/apechain#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive ApeChain 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 ApeChain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/apechain#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/apechain#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `apechain-mainnet` | | **Chain ID** | `33139` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [ApeChain Explorer](https://apechain.calderaexplorer.xyz/) | | **Official Website** | [ApeChain Website](https://apechain.com/) | | **Native Gas Token** | APE | [​](https://goldrush.dev/docs/chains/apechain#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/apechain#chain-name) Chain Name * `apechain-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/apechain#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/apechain-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/apechain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "apechain-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/apechain#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **23** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/apechain#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/apechain#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** #### [​](https://goldrush.dev/docs/chains/apechain#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/apechain#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/apechain#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/apechain#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/apechain#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [ADI Chain](https://goldrush.dev/docs/chains/adi-chain) [Arbitrum](https://goldrush.dev/docs/chains/arbitrum) ⌘I --- # Lens - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/lens#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Lens [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/lens#overview) * [Supported APIs](https://goldrush.dev/docs/chains/lens#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/lens#mainnet) * [Testnet](https://goldrush.dev/docs/chains/lens#testnet) * [API Usage](https://goldrush.dev/docs/chains/lens#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/lens#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/lens#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/lens#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/lens#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/lens#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/lens#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/lens#pricing-api) * [Security API](https://goldrush.dev/docs/chains/lens#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/lens#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/lens#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/lens#additional-resources) [​](https://goldrush.dev/docs/chains/lens#overview) Overview --------------------------------------------------------------- GoldRush offers the most comprehensive Lens 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 Lens Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/lens#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/lens#mainnet) Mainnet ------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `lens-mainnet` | | **Chain ID** | `232` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Lens Block Explorer](https://explorer.lens.xyz/) | | **Official Website** | [Lens Website](https://www.lens.xyz/) | | **Native Gas Token** | GHO | [​](https://goldrush.dev/docs/chains/lens#testnet) Testnet ------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `lens-sepolia-testnet` | | **Chain ID** | `37111` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Lens Network Testnet Block Explorer](https://explorer.staging.lens.zksync.dev/) | | **Official Website** | [Lens Testnet Website](https://www.lens.xyz/) | | **Native Gas Token** | GRASS | [​](https://goldrush.dev/docs/chains/lens#api-usage) API Usage ----------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/lens#chain-name) Chain Name * `lens-mainnet` (mainnet) * `lens-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/lens#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Lens Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/lens-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/lens#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Lens Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "lens-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/lens#foundational-api-support) Foundational API Support ----------------------------------------------------------------------------------------------- This chain supports **23** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/lens#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/lens#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** #### [​](https://goldrush.dev/docs/chains/lens#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/lens#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/lens#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/lens#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/lens#additional-resources) Additional Resources --------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Ink](https://goldrush.dev/docs/chains/ink) [Linea](https://goldrush.dev/docs/chains/linea) ⌘I --- # Mantle - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/mantle#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Mantle [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/mantle#overview) * [Supported APIs](https://goldrush.dev/docs/chains/mantle#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/mantle#mainnet) * [API Usage](https://goldrush.dev/docs/chains/mantle#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/mantle#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/mantle#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/mantle#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/mantle#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/mantle#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/mantle#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/mantle#pricing-api) * [Security API](https://goldrush.dev/docs/chains/mantle#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/mantle#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/mantle#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/mantle#additional-resources) [​](https://goldrush.dev/docs/chains/mantle#overview) Overview ----------------------------------------------------------------- GoldRush offers the most comprehensive Mantle 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 Mantle Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/mantle#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/mantle#mainnet) Mainnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `mantle-mainnet` | | **Chain ID** | `5000` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://explorer.mantle.xyz/) | | **Official Website** | [Mantle Website](https://www.mantle.xyz/) | | **Native Gas Token** | MNT | [​](https://goldrush.dev/docs/chains/mantle#api-usage) API Usage ------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/mantle#chain-name) Chain Name * `mantle-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/mantle#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/mantle-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/mantle#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "mantle-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/mantle#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------- This chain supports **23** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/mantle#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/mantle#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** #### [​](https://goldrush.dev/docs/chains/mantle#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/mantle#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/mantle#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/mantle#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/mantle#additional-resources) Additional Resources ----------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Linea](https://goldrush.dev/docs/chains/linea) [Monad](https://goldrush.dev/docs/chains/monad) ⌘I --- # Sei - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/sei#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Sei [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/sei#overview) * [Supported APIs](https://goldrush.dev/docs/chains/sei#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/sei#mainnet) * [API Usage](https://goldrush.dev/docs/chains/sei#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/sei#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/sei#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/sei#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/sei#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/sei#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/sei#pricing-api) * [Security API](https://goldrush.dev/docs/chains/sei#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/sei#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/sei#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/sei#additional-resources) [​](https://goldrush.dev/docs/chains/sei#overview) Overview -------------------------------------------------------------- GoldRush offers the most comprehensive Sei 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 Sei Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/sei#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/sei#mainnet) Mainnet ------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `sei-mainnet` | | **Chain ID** | `1329` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://seistream.app/) | | **Official Website** | [Sei Website](https://www.sei.io/) | | **Native Gas Token** | SEI | [​](https://goldrush.dev/docs/chains/sei#api-usage) API Usage ---------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/sei#chain-name) Chain Name * `sei-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/sei#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/sei-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/sei#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "sei-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/sei#foundational-api-support) Foundational API Support ---------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/sei#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/sei#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/sei#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/sei#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/sei#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/sei#additional-resources) Additional Resources -------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Scroll](https://goldrush.dev/docs/chains/scroll) [Solana](https://goldrush.dev/docs/chains/solana) ⌘I --- # Blast - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/blast#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Blast [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/blast#overview) * [Supported APIs](https://goldrush.dev/docs/chains/blast#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/blast#mainnet) * [API Usage](https://goldrush.dev/docs/chains/blast#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/blast#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/blast#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/blast#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/blast#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/blast#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/blast#pricing-api) * [Security API](https://goldrush.dev/docs/chains/blast#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/blast#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/blast#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/blast#additional-resources) [​](https://goldrush.dev/docs/chains/blast#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive Blast 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 Blast Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/blast#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/blast#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `blast-mainnet` | | **Chain ID** | `81457` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://blastexplorer.io/) | | **Official Website** | [Blast Website](https://blast.io/en) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/blast#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/blast#chain-name) Chain Name * `blast-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/blast#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/blast-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/blast#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "blast-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/blast#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/blast#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/blast#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/blast#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/blast#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/blast#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/blast#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Fantom](https://goldrush.dev/docs/chains/fantom) [opBNB](https://goldrush.dev/docs/chains/opbnb) ⌘I --- # Taiko - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/taiko#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Taiko [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/taiko#overview) * [Supported APIs](https://goldrush.dev/docs/chains/taiko#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/taiko#mainnet) * [API Usage](https://goldrush.dev/docs/chains/taiko#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/taiko#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/taiko#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/taiko#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/taiko#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/taiko#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/taiko#pricing-api) * [Security API](https://goldrush.dev/docs/chains/taiko#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/taiko#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/taiko#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/taiko#additional-resources) [​](https://goldrush.dev/docs/chains/taiko#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive Taiko 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 Taiko Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/taiko#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/taiko#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `taiko-mainnet` | | **Chain ID** | `167000` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://taikoscan.network/) | | **Official Website** | [Taiko Website](https://taiko.xyz/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/taiko#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/taiko#chain-name) Chain Name * `taiko-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/taiko#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/taiko-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/taiko#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "taiko-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/taiko#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/taiko#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/taiko#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/taiko#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/taiko#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/taiko#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/taiko#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Sonic](https://goldrush.dev/docs/chains/sonic) [Unichain](https://goldrush.dev/docs/chains/unichain) ⌘I --- # Scroll - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/scroll#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Scroll [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/scroll#overview) * [Supported APIs](https://goldrush.dev/docs/chains/scroll#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/scroll#mainnet) * [API Usage](https://goldrush.dev/docs/chains/scroll#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/scroll#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/scroll#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/scroll#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/scroll#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/scroll#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/scroll#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/scroll#pricing-api) * [Security API](https://goldrush.dev/docs/chains/scroll#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/scroll#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/scroll#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/scroll#additional-resources) [​](https://goldrush.dev/docs/chains/scroll#overview) Overview ----------------------------------------------------------------- GoldRush offers the most comprehensive Scroll 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 Scroll Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/scroll#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/scroll#mainnet) Mainnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `scroll-mainnet` | | **Chain ID** | `534352` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://blockscout.scroll.io/) | | **Official Website** | [Scroll Website](https://scroll.io/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/scroll#api-usage) API Usage ------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/scroll#chain-name) Chain Name * `scroll-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/scroll#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/scroll-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/scroll#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "scroll-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/scroll#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------- This chain supports **23** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/scroll#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/scroll#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** #### [​](https://goldrush.dev/docs/chains/scroll#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/scroll#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/scroll#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/scroll#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/scroll#additional-resources) Additional Resources ----------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Plasma](https://goldrush.dev/docs/chains/plasma) [Sei](https://goldrush.dev/docs/chains/sei) ⌘I --- # Covalent - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/covalent#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Covalent [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/covalent#overview) * [Supported APIs](https://goldrush.dev/docs/chains/covalent#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/covalent#mainnet) * [API Usage](https://goldrush.dev/docs/chains/covalent#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/covalent#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/covalent#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/covalent#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/covalent#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/covalent#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/covalent#pricing-api) * [Security API](https://goldrush.dev/docs/chains/covalent#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/covalent#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/covalent#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/covalent#additional-resources) [​](https://goldrush.dev/docs/chains/covalent#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive Covalent 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 Covalent Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/covalent#supported-apis) Supported APIs [​](https://goldrush.dev/docs/chains/covalent#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `covalent-internal-network-v1` | | **Chain ID** | `1131378225` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://cqtscan.com/#/) | | **Official Website** | [Covalent Website](https://covalenthq.com/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/covalent#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/covalent#chain-name) Chain Name * `covalent-internal-network-v1` (mainnet) #### [​](https://goldrush.dev/docs/chains/covalent#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/covalent-internal-network-v1/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/covalent#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "covalent-internal-network-v1", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/covalent#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **34** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/covalent#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/covalent#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/covalent#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/covalent#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/covalent#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/covalent#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Celo](https://goldrush.dev/docs/chains/celo) [Cronos zkEVM](https://goldrush.dev/docs/chains/cronos-zkevm) ⌘I --- # Ink - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/ink#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Ink [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/ink#overview) * [Supported APIs](https://goldrush.dev/docs/chains/ink#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/ink#mainnet) * [Testnet](https://goldrush.dev/docs/chains/ink#testnet) * [API Usage](https://goldrush.dev/docs/chains/ink#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/ink#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/ink#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/ink#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/ink#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/ink#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/ink#pricing-api) * [Security API](https://goldrush.dev/docs/chains/ink#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/ink#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/ink#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/ink#additional-resources) [​](https://goldrush.dev/docs/chains/ink#overview) Overview -------------------------------------------------------------- GoldRush offers the most comprehensive Ink 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 Ink Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/ink#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/ink#mainnet) Mainnet ------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `ink-mainnet` | | **Chain ID** | `57073` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Ink Explorer](https://explorer-sepolia.inkonchain.com/) | | **Official Website** | [Ink Website](https://inkonchain.com/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/ink#testnet) Testnet ------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `ink-sepolia-testnet` | | **Chain ID** | `763373` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Ink Sepolia Explorer](https://explorer-sepolia.inkonchain.com/) | | **Official Website** | [Ink Testnet Website](https://inkonchain.com/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/ink#api-usage) API Usage ---------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/ink#chain-name) Chain Name * `ink-mainnet` (mainnet) * `ink-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/ink#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Ink Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/ink-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/ink#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Ink Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "ink-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/ink#foundational-api-support) Foundational API Support ---------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/ink#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/ink#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/ink#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/ink#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/ink#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/ink#additional-resources) Additional Resources -------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [HyperEVM](https://goldrush.dev/docs/chains/hyperevm) [Lens](https://goldrush.dev/docs/chains/lens) ⌘I --- # Oasis - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/oasis#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Oasis [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/oasis#overview) * [Supported APIs](https://goldrush.dev/docs/chains/oasis#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/oasis#mainnet) * [API Usage](https://goldrush.dev/docs/chains/oasis#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/oasis#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/oasis#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/oasis#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/oasis#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/oasis#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/oasis#pricing-api) * [Security API](https://goldrush.dev/docs/chains/oasis#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/oasis#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/oasis#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/oasis#additional-resources) [​](https://goldrush.dev/docs/chains/oasis#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive Oasis 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 Oasis Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/oasis#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/oasis#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `emerald-paratime-mainnet` | | **Chain ID** | `42262` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://explorer.emerald.oasis.dev/) | | **Official Website** | [Oasis Website](https://oasisprotocol.org/) | | **Native Gas Token** | ROSE | [​](https://goldrush.dev/docs/chains/oasis#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/oasis#chain-name) Chain Name * `emerald-paratime-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/oasis#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/emerald-paratime-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/oasis#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "emerald-paratime-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/oasis#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/oasis#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/oasis#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/oasis#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/oasis#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/oasis#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/oasis#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Cronos zkEVM](https://goldrush.dev/docs/chains/cronos-zkevm) [Manta Pacific Testnet](https://goldrush.dev/docs/chains/manta-pacific) ⌘I --- # Oasis Sapphire - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/oasis-sapphire#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Oasis Sapphire [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/oasis-sapphire#overview) * [Supported APIs](https://goldrush.dev/docs/chains/oasis-sapphire#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/oasis-sapphire#mainnet) * [API Usage](https://goldrush.dev/docs/chains/oasis-sapphire#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/oasis-sapphire#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/oasis-sapphire#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/oasis-sapphire#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/oasis-sapphire#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/oasis-sapphire#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/oasis-sapphire#pricing-api) * [Security API](https://goldrush.dev/docs/chains/oasis-sapphire#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/oasis-sapphire#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/oasis-sapphire#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/oasis-sapphire#additional-resources) [​](https://goldrush.dev/docs/chains/oasis-sapphire#overview) Overview ------------------------------------------------------------------------- GoldRush offers the most comprehensive Oasis Sapphire 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 Oasis Sapphire Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/oasis-sapphire#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/oasis-sapphire#mainnet) Mainnet ----------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `oasis-sapphire-mainnet` | | **Chain ID** | `23294` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://explorer.sapphire.oasis.io/) | | **Official Website** | [Oasis Sapphire Website](https://docs.oasis.io/dapp/sapphire/) | | **Native Gas Token** | ROSE | [​](https://goldrush.dev/docs/chains/oasis-sapphire#api-usage) API Usage --------------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#chain-name) Chain Name * `oasis-sapphire-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/oasis-sapphire-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "oasis-sapphire-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/oasis-sapphire#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/oasis-sapphire#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/oasis-sapphire#additional-resources) Additional Resources ------------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) * [AppChain Documentation](https://goldrush.dev/docs/appchains/) [Monad](https://goldrush.dev/docs/chains/monad) [Plasma](https://goldrush.dev/docs/chains/plasma) ⌘I --- # Redstone - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/redstone#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Redstone [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/redstone#overview) * [Supported APIs](https://goldrush.dev/docs/chains/redstone#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/redstone#mainnet) * [API Usage](https://goldrush.dev/docs/chains/redstone#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/redstone#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/redstone#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/redstone#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/redstone#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/redstone#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/redstone#pricing-api) * [Security API](https://goldrush.dev/docs/chains/redstone#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/redstone#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/redstone#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/redstone#additional-resources) [​](https://goldrush.dev/docs/chains/redstone#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive Redstone 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 Redstone Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/redstone#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/redstone#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `redstone-mainnet` | | **Chain ID** | `690` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://explorer.redstone.xyz/) | | **Official Website** | [Redstone Website](https://redstone.xyz/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/redstone#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/redstone#chain-name) Chain Name * `redstone-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/redstone#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/redstone-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/redstone#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "redstone-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/redstone#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/redstone#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/redstone#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/redstone#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/redstone#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/redstone#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/redstone#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Moonriver](https://goldrush.dev/docs/chains/moonriver) [ZetaChain](https://goldrush.dev/docs/chains/zetachain) ⌘I --- # Fantom - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/fantom#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Fantom [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/fantom#overview) * [Supported APIs](https://goldrush.dev/docs/chains/fantom#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/fantom#mainnet) * [Testnet](https://goldrush.dev/docs/chains/fantom#testnet) * [API Usage](https://goldrush.dev/docs/chains/fantom#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/fantom#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/fantom#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/fantom#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/fantom#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/fantom#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/fantom#pricing-api) * [Security API](https://goldrush.dev/docs/chains/fantom#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/fantom#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/fantom#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/fantom#additional-resources) [​](https://goldrush.dev/docs/chains/fantom#overview) Overview ----------------------------------------------------------------- GoldRush offers the most comprehensive Fantom 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 Fantom Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/fantom#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/fantom#mainnet) Mainnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `fantom-mainnet` | | **Chain ID** | `250` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://ftmscan.com/) | | **Official Website** | [Fantom Website](https://fantom.foundation/) | | **Native Gas Token** | FTM | [​](https://goldrush.dev/docs/chains/fantom#testnet) Testnet --------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `fantom-testnet` | | **Chain ID** | `4002` | | **Purpose** | Development and testing network | | **Support Level** | community | | **Block Explorer** | [Explorer](https://testnet.ftmscan.com/) | | **Native Gas Token** | gwei | [​](https://goldrush.dev/docs/chains/fantom#api-usage) API Usage ------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/fantom#chain-name) Chain Name * `fantom-mainnet` (mainnet) * `fantom-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/fantom#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Fantom Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/fantom-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/fantom#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Fantom Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "fantom-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/fantom#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/fantom#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/fantom#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/fantom#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/fantom#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/fantom#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/fantom#additional-resources) Additional Resources ----------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [zkSync Era](https://goldrush.dev/docs/chains/zksync-era) [Blast](https://goldrush.dev/docs/chains/blast) ⌘I --- # Unichain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/unichain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Unichain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/unichain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/unichain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/unichain#mainnet) * [Testnet](https://goldrush.dev/docs/chains/unichain#testnet) * [API Usage](https://goldrush.dev/docs/chains/unichain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/unichain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/unichain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/unichain#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/unichain#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/unichain#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/unichain#pricing-api) * [Security API](https://goldrush.dev/docs/chains/unichain#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/unichain#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/unichain#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/unichain#additional-resources) [​](https://goldrush.dev/docs/chains/unichain#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive Unichain 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 Unichain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/unichain#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/unichain#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `unichain-mainnet` | | **Chain ID** | `130` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Unichain Explorer](https://unichain.blockscout.com/) | | **Official Website** | [Unichain Website](https://www.unichain.org/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/unichain#testnet) Testnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `unichain-sepolia-testnet` | | **Chain ID** | `1301` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Unichain Sepolia Testnet Explorer](https://sepolia.uniscan.xyz/) | | **Official Website** | [Unichain Testnet Website](https://www.unichain.org/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/unichain#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/unichain#chain-name) Chain Name * `unichain-mainnet` (mainnet) * `unichain-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/unichain#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Unichain Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/unichain-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/unichain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Unichain Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "unichain-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/unichain#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/unichain#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/unichain#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/unichain#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/unichain#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/unichain#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/unichain#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Taiko](https://goldrush.dev/docs/chains/taiko) [Viction](https://goldrush.dev/docs/chains/viction) ⌘I --- # Moonbeam - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/moonbeam#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Moonbeam [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/moonbeam#overview) * [Supported APIs](https://goldrush.dev/docs/chains/moonbeam#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/moonbeam#mainnet) * [API Usage](https://goldrush.dev/docs/chains/moonbeam#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/moonbeam#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/moonbeam#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/moonbeam#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/moonbeam#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/moonbeam#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/moonbeam#pricing-api) * [Security API](https://goldrush.dev/docs/chains/moonbeam#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/moonbeam#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/moonbeam#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/moonbeam#additional-resources) [​](https://goldrush.dev/docs/chains/moonbeam#overview) Overview ------------------------------------------------------------------- GoldRush offers the most comprehensive Moonbeam 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 Moonbeam Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/moonbeam#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/moonbeam#mainnet) Mainnet ----------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `moonbeam-mainnet` | | **Chain ID** | `1284` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://moonscan.io/) | | **Official Website** | [Moonbeam Website](https://moonbeam.network/) | | **Native Gas Token** | GLMR | [​](https://goldrush.dev/docs/chains/moonbeam#api-usage) API Usage --------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/moonbeam#chain-name) Chain Name * `moonbeam-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/moonbeam#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/moonbeam-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/moonbeam#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "moonbeam-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/moonbeam#foundational-api-support) Foundational API Support --------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/moonbeam#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/moonbeam#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/moonbeam#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/moonbeam#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/moonbeam#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/moonbeam#additional-resources) Additional Resources ------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Manta Pacific Testnet](https://goldrush.dev/docs/chains/manta-pacific) [Moonriver](https://goldrush.dev/docs/chains/moonriver) ⌘I --- # Viction - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/viction#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Viction [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/viction#overview) * [Supported APIs](https://goldrush.dev/docs/chains/viction#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/viction#mainnet) * [API Usage](https://goldrush.dev/docs/chains/viction#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/viction#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/viction#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/viction#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/viction#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/viction#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/viction#pricing-api) * [Security API](https://goldrush.dev/docs/chains/viction#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/viction#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/viction#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/viction#additional-resources) [​](https://goldrush.dev/docs/chains/viction#overview) Overview ------------------------------------------------------------------ GoldRush offers the most comprehensive Viction 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 Viction Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/viction#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/viction#mainnet) Mainnet ---------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `viction-mainnet` | | **Chain ID** | `88` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://www.vicscan.xyz/) | | **Official Website** | [Viction Website](https://viction.xyz/) | | **Native Gas Token** | TOMO | [​](https://goldrush.dev/docs/chains/viction#api-usage) API Usage -------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/viction#chain-name) Chain Name * `viction-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/viction#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/viction-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/viction#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "viction-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/viction#foundational-api-support) Foundational API Support -------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/viction#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/viction#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/viction#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/viction#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/viction#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/viction#additional-resources) Additional Resources ------------------------------------------------------------------------------------------ * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Unichain](https://goldrush.dev/docs/chains/unichain) [World Chain](https://goldrush.dev/docs/chains/world-chain) ⌘I --- # Canto - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/canto#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Canto [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/canto#overview) * [Supported APIs](https://goldrush.dev/docs/chains/canto#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/canto#mainnet) * [API Usage](https://goldrush.dev/docs/chains/canto#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/canto#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/canto#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/canto#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/canto#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/canto#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/canto#pricing-api) * [Security API](https://goldrush.dev/docs/chains/canto#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/canto#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/canto#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/canto#additional-resources) [​](https://goldrush.dev/docs/chains/canto#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive Canto 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 Canto Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/canto#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/canto#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `canto-mainnet` | | **Chain ID** | `7700` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://evm.explorer.canto.io/) | | **Official Website** | [Canto Website](https://canto.io/) | | **Native Gas Token** | Canto | [​](https://goldrush.dev/docs/chains/canto#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/canto#chain-name) Chain Name * `canto-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/canto#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/canto-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/canto#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "canto-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/canto#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/canto#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/canto#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/canto#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/canto#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/canto#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/canto#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [opBNB](https://goldrush.dev/docs/chains/opbnb) [Celo](https://goldrush.dev/docs/chains/celo) ⌘I --- # Celo - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/celo#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Celo [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/celo#overview) * [Supported APIs](https://goldrush.dev/docs/chains/celo#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/celo#mainnet) * [API Usage](https://goldrush.dev/docs/chains/celo#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/celo#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/celo#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/celo#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/celo#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/celo#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/celo#pricing-api) * [Security API](https://goldrush.dev/docs/chains/celo#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/celo#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/celo#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/celo#additional-resources) [​](https://goldrush.dev/docs/chains/celo#overview) Overview --------------------------------------------------------------- GoldRush offers the most comprehensive Celo 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 Celo Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/celo#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/celo#mainnet) Mainnet ------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `celo-mainnet` | | **Chain ID** | `42220` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://explorer.celo.org/mainnet/) | | **Official Website** | [Celo Website](https://docs.celo.org/) | | **Native Gas Token** | CELO | [​](https://goldrush.dev/docs/chains/celo#api-usage) API Usage ----------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/celo#chain-name) Chain Name * `celo-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/celo#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/celo-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/celo#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "celo-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/celo#foundational-api-support) Foundational API Support ----------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/celo#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/celo#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/celo#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/celo#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/celo#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/celo#additional-resources) Additional Resources --------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Canto](https://goldrush.dev/docs/chains/canto) [Covalent](https://goldrush.dev/docs/chains/covalent) ⌘I --- # Cronos zkEVM - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/cronos-zkevm#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Cronos zkEVM [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/cronos-zkevm#overview) * [Supported APIs](https://goldrush.dev/docs/chains/cronos-zkevm#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/cronos-zkevm#mainnet) * [API Usage](https://goldrush.dev/docs/chains/cronos-zkevm#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/cronos-zkevm#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/cronos-zkevm#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/cronos-zkevm#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/cronos-zkevm#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/cronos-zkevm#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/cronos-zkevm#pricing-api) * [Security API](https://goldrush.dev/docs/chains/cronos-zkevm#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/cronos-zkevm#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/cronos-zkevm#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/cronos-zkevm#additional-resources) [​](https://goldrush.dev/docs/chains/cronos-zkevm#overview) Overview ----------------------------------------------------------------------- GoldRush offers the most comprehensive Cronos zkEVM 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 Cronos zkEVM Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/cronos-zkevm#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/cronos-zkevm#mainnet) Mainnet --------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `cronos-zkevm-mainnet` | | **Chain ID** | `388` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://explorer.zkevm.cronos.org/) | | **Official Website** | [Cronos zkEVM Website](https://docs.cronos.org/cronos-zkevm/cronos-zkevm) | | **Native Gas Token** | zkCRO | [​](https://goldrush.dev/docs/chains/cronos-zkevm#api-usage) API Usage ------------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#chain-name) Chain Name * `cronos-zkevm-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/cronos-zkevm-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "cronos-zkevm-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/cronos-zkevm#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/cronos-zkevm#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/cronos-zkevm#additional-resources) Additional Resources ----------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Covalent](https://goldrush.dev/docs/chains/covalent) [Oasis](https://goldrush.dev/docs/chains/oasis) ⌘I --- # Moonriver - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/moonriver#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains Moonriver [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/moonriver#overview) * [Supported APIs](https://goldrush.dev/docs/chains/moonriver#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/moonriver#mainnet) * [API Usage](https://goldrush.dev/docs/chains/moonriver#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/moonriver#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/moonriver#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/moonriver#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/moonriver#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/moonriver#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/moonriver#pricing-api) * [Security API](https://goldrush.dev/docs/chains/moonriver#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/moonriver#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/moonriver#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/moonriver#additional-resources) [​](https://goldrush.dev/docs/chains/moonriver#overview) Overview -------------------------------------------------------------------- GoldRush offers the most comprehensive Moonriver 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 Moonriver Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/moonriver#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/moonriver#mainnet) Mainnet ------------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `moonbeam-moonriver` | | **Chain ID** | `1285` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://moonriver.moonscan.io/) | | **Official Website** | [Moonriver Website](https://moonbeam.network/networks/moonriver/) | | **Native Gas Token** | MOVR | [​](https://goldrush.dev/docs/chains/moonriver#api-usage) API Usage ---------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/moonriver#chain-name) Chain Name * `moonbeam-moonriver` (mainnet) #### [​](https://goldrush.dev/docs/chains/moonriver#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/moonbeam-moonriver/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/moonriver#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "moonbeam-moonriver", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/moonriver#foundational-api-support) Foundational API Support ---------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/moonriver#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/moonriver#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/moonriver#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/moonriver#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/moonriver#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/moonriver#additional-resources) Additional Resources -------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Moonbeam](https://goldrush.dev/docs/chains/moonbeam) [Redstone](https://goldrush.dev/docs/chains/redstone) ⌘I --- # World Chain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/world-chain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains World Chain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/world-chain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/world-chain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/world-chain#mainnet) * [Testnet](https://goldrush.dev/docs/chains/world-chain#testnet) * [API Usage](https://goldrush.dev/docs/chains/world-chain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/world-chain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/world-chain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/world-chain#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/world-chain#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/world-chain#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/world-chain#pricing-api) * [Security API](https://goldrush.dev/docs/chains/world-chain#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/world-chain#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/world-chain#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/world-chain#additional-resources) [​](https://goldrush.dev/docs/chains/world-chain#overview) Overview ---------------------------------------------------------------------- GoldRush offers the most comprehensive World Chain 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 World Chain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/world-chain#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/world-chain#mainnet) Mainnet -------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `world-mainnet` | | **Chain ID** | `480` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [World Chain Mainnet Explorer](https://worldscan.org/) | | **Official Website** | [World Chain Website](https://world.org/world-chain) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/world-chain#testnet) Testnet -------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `world-sepolia-testnet` | | **Chain ID** | `4801` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [World Chain Sepolia Explorer](https://worldchain-sepolia.explorer.alchemy.com/) | | **Official Website** | [World Chain Testnet Website](https://world.org/world-chain) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/world-chain#api-usage) API Usage ------------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/world-chain#chain-name) Chain Name * `world-mainnet` (mainnet) * `world-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/world-chain#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (World Chain Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/world-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/world-chain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (World Chain Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "world-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/world-chain#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/world-chain#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/world-chain#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/world-chain#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/world-chain#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/world-chain#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/world-chain#additional-resources) Additional Resources ---------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Viction](https://goldrush.dev/docs/chains/viction) [zkSync Era](https://goldrush.dev/docs/chains/zksync-era) ⌘I --- # Linea - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/linea#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Linea [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/linea#overview) * [Supported APIs](https://goldrush.dev/docs/chains/linea#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/linea#mainnet) * [Testnet](https://goldrush.dev/docs/chains/linea#testnet) * [API Usage](https://goldrush.dev/docs/chains/linea#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/linea#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/linea#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/linea#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/linea#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/linea#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/linea#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/linea#pricing-api) * [Security API](https://goldrush.dev/docs/chains/linea#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/linea#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/linea#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/linea#additional-resources) [​](https://goldrush.dev/docs/chains/linea#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive Linea 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 Linea Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/linea#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/linea#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `linea-mainnet` | | **Chain ID** | `59144` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://lineascan.build/) | | **Official Website** | [Linea Website](https://linea.build/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/linea#testnet) Testnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `linea-sepolia-testnet` | | **Chain ID** | `59141` | | **Purpose** | Development and testing network | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://sepolia.lineascan.build/) | | **Official Website** | [Linea Sepolia Testnet Website](https://linea.build/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/linea#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/linea#chain-name) Chain Name * `linea-mainnet` (mainnet) * `linea-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/linea#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Linea Sepolia Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/linea-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/linea#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Linea Sepolia Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "linea-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/linea#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **23** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/linea#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/linea#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** #### [​](https://goldrush.dev/docs/chains/linea#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/linea#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/linea#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/linea#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/linea#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Lens](https://goldrush.dev/docs/chains/lens) [Mantle](https://goldrush.dev/docs/chains/mantle) ⌘I --- # Arbitrum Nova - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/arbitrum-nova#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains Arbitrum Nova [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/arbitrum-nova#overview) * [Supported APIs](https://goldrush.dev/docs/chains/arbitrum-nova#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/arbitrum-nova#mainnet) * [API Usage](https://goldrush.dev/docs/chains/arbitrum-nova#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/arbitrum-nova#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/arbitrum-nova#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/arbitrum-nova#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/arbitrum-nova#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/arbitrum-nova#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/arbitrum-nova#pricing-api) * [Security API](https://goldrush.dev/docs/chains/arbitrum-nova#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/arbitrum-nova#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/arbitrum-nova#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/arbitrum-nova#additional-resources) [​](https://goldrush.dev/docs/chains/arbitrum-nova#overview) Overview ------------------------------------------------------------------------ GoldRush offers the most comprehensive Arbitrum Nova 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 Arbitrum Nova Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/arbitrum-nova#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/arbitrum-nova#mainnet) Mainnet ---------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `arbitrum-nova-mainnet` | | **Chain ID** | `42170` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Nova Arbiscan](https://nova.arbiscan.io/) | | **Official Website** | [Arbitrum Nova Website](https://nova.arbitrum.io/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/arbitrum-nova#api-usage) API Usage -------------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#chain-name) Chain Name * `arbitrum-nova-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/arbitrum-nova-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "arbitrum-nova-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/arbitrum-nova#foundational-api-support) Foundational API Support -------------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/arbitrum-nova#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/arbitrum-nova#additional-resources) Additional Resources ------------------------------------------------------------------------------------------------ * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) * [AppChain Documentation](https://goldrush.dev/docs/appchains/) [Arbitrum](https://goldrush.dev/docs/chains/arbitrum) [Arc Testnet](https://goldrush.dev/docs/chains/arc) ⌘I --- # ZetaChain - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/zetachain#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains ZetaChain [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/zetachain#overview) * [Supported APIs](https://goldrush.dev/docs/chains/zetachain#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/zetachain#mainnet) * [API Usage](https://goldrush.dev/docs/chains/zetachain#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/zetachain#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/zetachain#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/zetachain#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/zetachain#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/zetachain#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/zetachain#pricing-api) * [Security API](https://goldrush.dev/docs/chains/zetachain#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/zetachain#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/zetachain#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/zetachain#additional-resources) [​](https://goldrush.dev/docs/chains/zetachain#overview) Overview -------------------------------------------------------------------- GoldRush offers the most comprehensive ZetaChain 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 ZetaChain Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/zetachain#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/zetachain#mainnet) Mainnet ------------------------------------------------------------------ | **Property** | **Value** | | --- | --- | | **Chain Name** | `zetachain-mainnet` | | **Chain ID** | `7000` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://explorer.zetachain.com/) | | **Official Website** | [ZetaChain Website](https://www.zetachain.com/) | | **Native Gas Token** | ZETA | [​](https://goldrush.dev/docs/chains/zetachain#api-usage) API Usage ---------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/zetachain#chain-name) Chain Name * `zetachain-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/zetachain#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/zetachain-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/zetachain#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "zetachain-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/zetachain#foundational-api-support) Foundational API Support ---------------------------------------------------------------------------------------------------- This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/zetachain#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/zetachain#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/zetachain#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/zetachain#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/zetachain#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/zetachain#additional-resources) Additional Resources -------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Redstone](https://goldrush.dev/docs/chains/redstone) [Cronos](https://goldrush.dev/docs/chains/cronos) ⌘I --- # Base - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/base#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Foundational Chains Base [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/base#overview) * [Supported APIs](https://goldrush.dev/docs/chains/base#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/base#mainnet) * [Testnet](https://goldrush.dev/docs/chains/base#testnet) * [API Usage](https://goldrush.dev/docs/chains/base#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/base#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/base#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/base#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/base#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/base#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/base#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/base#pricing-api) * [Security API](https://goldrush.dev/docs/chains/base#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/base#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/base#block-explorer-api) * [Streaming API Support](https://goldrush.dev/docs/chains/base#streaming-api-support) * [Additional Resources](https://goldrush.dev/docs/chains/base#additional-resources) [​](https://goldrush.dev/docs/chains/base#overview) Overview --------------------------------------------------------------- GoldRush offers the most comprehensive Base 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 Base Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/base#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [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](https://goldrush.dev/docs/goldrush-streaming-api) [​](https://goldrush.dev/docs/chains/base#mainnet) Mainnet ------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `base-mainnet` | | **Chain ID** | `8453` | | **Network Type** | Foundational Chain | | **Support Level** | foundational | | **Block Explorer** | [Base Explorer](https://basescan.org/) | | **Official Website** | [Base Website](https://base.org/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/base#testnet) Testnet ------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `base-sepolia-testnet` | | **Chain ID** | `84532` | | **Purpose** | Development and testing network | | **Support Level** | foundational | | **Block Explorer** | [Base Sepolia Explorer](https://base-sepolia.blockscout.com/) | | **Official Website** | [Base Sepolia Testnet Website](https://docs.base.org/base-contracts/#base-testnet-goerli--sepolia) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/base#api-usage) API Usage ----------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/base#chain-name) Chain Name * `base-mainnet` (mainnet) * `base-sepolia-testnet` (testnet) #### [​](https://goldrush.dev/docs/chains/base#example-api-calls) Example API Calls Chain Name (Mainnet) Chain Name (Base Sepolia Testnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/base-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/base#sdk-usage) SDK Usage TypeScript SDK (Mainnet) TypeScript SDK (Base Sepolia Testnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "base-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/base#foundational-api-support) Foundational API Support ----------------------------------------------------------------------------------------------- This chain supports **28** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/base#wallet-api) Wallet API * **[Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) ** * **[Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) ** * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/base#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** * **[Check ownership in NFT collection](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection) ** * **[Check ownership in NFT collection for specific token](https://goldrush.dev/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token) ** #### [​](https://goldrush.dev/docs/chains/base#pricing-api) Pricing API * **[Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) ** * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/base#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/base#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/base#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/base#streaming-api-support) Streaming API Support ----------------------------------------------------------------------------------------- This chain supports the following GoldRush Streaming APIs: * [New DEX Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/new-dex-pairs-stream) * [OHLCV Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-pairs-stream) * [OHLCV Tokens Stream](https://goldrush.dev/docs/goldrush-streaming-api/ohlcv-tokens-stream) * [Update Pairs Stream](https://goldrush.dev/docs/goldrush-streaming-api/update-pairs-stream) * [Wallet Activity Stream](https://goldrush.dev/docs/goldrush-streaming-api/wallet-activity-stream) [​](https://goldrush.dev/docs/chains/base#additional-resources) Additional Resources --------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [Optimism](https://goldrush.dev/docs/chains/optimism) [Gnosis](https://goldrush.dev/docs/chains/gnosis) ⌘I --- # zkSync Era - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/zksync-era#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Frontier Chains zkSync Era [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/zksync-era#overview) * [Supported APIs](https://goldrush.dev/docs/chains/zksync-era#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/zksync-era#mainnet) * [API Usage](https://goldrush.dev/docs/chains/zksync-era#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/zksync-era#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/zksync-era#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/zksync-era#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/zksync-era#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/zksync-era#wallet-api) * [NFT API](https://goldrush.dev/docs/chains/zksync-era#nft-api) * [Pricing API](https://goldrush.dev/docs/chains/zksync-era#pricing-api) * [Security API](https://goldrush.dev/docs/chains/zksync-era#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/zksync-era#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/zksync-era#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/zksync-era#additional-resources) [​](https://goldrush.dev/docs/chains/zksync-era#overview) Overview --------------------------------------------------------------------- GoldRush offers the most comprehensive zkSync Era 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 zkSync Era Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/zksync-era#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/zksync-era#mainnet) Mainnet ------------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `zksync-mainnet` | | **Chain ID** | `324` | | **Network Type** | Frontier Chain | | **Support Level** | frontier | | **Block Explorer** | [Explorer](https://explorer.zksync.io/) | | **Official Website** | [zkSync Era Website](https://zksync.io/) | | **Native Gas Token** | ETH | [​](https://goldrush.dev/docs/chains/zksync-era#api-usage) API Usage ----------------------------------------------------------------------- To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/zksync-era#chain-name) Chain Name * `zksync-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/zksync-era#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/zksync-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/zksync-era#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "zksync-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/zksync-era#foundational-api-support) Foundational API Support ----------------------------------------------------------------------------------------------------- This chain supports **23** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/zksync-era#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/zksync-era#nft-api) NFT API * **[Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ** #### [​](https://goldrush.dev/docs/chains/zksync-era#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/zksync-era#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/zksync-era#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/zksync-era#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/zksync-era#additional-resources) Additional Resources --------------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) [World Chain](https://goldrush.dev/docs/chains/world-chain) [Fantom](https://goldrush.dev/docs/chains/fantom) ⌘I --- # opBNB - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/chains/opbnb#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Community Chains opBNB [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) On this page * [Overview](https://goldrush.dev/docs/chains/opbnb#overview) * [Supported APIs](https://goldrush.dev/docs/chains/opbnb#supported-apis) * [Mainnet](https://goldrush.dev/docs/chains/opbnb#mainnet) * [API Usage](https://goldrush.dev/docs/chains/opbnb#api-usage) * [Chain Name](https://goldrush.dev/docs/chains/opbnb#chain-name) * [Example API Calls](https://goldrush.dev/docs/chains/opbnb#example-api-calls) * [SDK Usage](https://goldrush.dev/docs/chains/opbnb#sdk-usage) * [Foundational API Support](https://goldrush.dev/docs/chains/opbnb#foundational-api-support) * [Wallet API](https://goldrush.dev/docs/chains/opbnb#wallet-api) * [Pricing API](https://goldrush.dev/docs/chains/opbnb#pricing-api) * [Security API](https://goldrush.dev/docs/chains/opbnb#security-api) * [Activity Feed API](https://goldrush.dev/docs/chains/opbnb#activity-feed-api) * [Block Explorer API](https://goldrush.dev/docs/chains/opbnb#block-explorer-api) * [Additional Resources](https://goldrush.dev/docs/chains/opbnb#additional-resources) [​](https://goldrush.dev/docs/chains/opbnb#overview) Overview ---------------------------------------------------------------- GoldRush offers the most comprehensive opBNB 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 opBNB Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need. ### [​](https://goldrush.dev/docs/chains/opbnb#supported-apis) 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](https://goldrush.dev/docs/goldrush-foundational-api) [​](https://goldrush.dev/docs/chains/opbnb#mainnet) Mainnet -------------------------------------------------------------- | **Property** | **Value** | | --- | --- | | **Chain Name** | `bnb-opbnb-mainnet` | | **Chain ID** | `204` | | **Network Type** | Community Chain | | **Support Level** | community | | **Block Explorer** | [Explorer](https://opbnbscan.com/) | | **Official Website** | [opBNB Website](https://opbnb.bnbchain.org/en) | | **Native Gas Token** | BNB | [​](https://goldrush.dev/docs/chains/opbnb#api-usage) API Usage ------------------------------------------------------------------ To use this blockchain network in GoldRush API calls, use: #### [​](https://goldrush.dev/docs/chains/opbnb#chain-name) Chain Name * `bnb-opbnb-mainnet` (mainnet) #### [​](https://goldrush.dev/docs/chains/opbnb#example-api-calls) Example API Calls Chain Name (Mainnet) Copy Ask AI curl -X GET "https://api.covalenthq.com/v1/bnb-opbnb-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=API_KEY" #### [​](https://goldrush.dev/docs/chains/opbnb#sdk-usage) SDK Usage TypeScript SDK (Mainnet) Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient("API_KEY"); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "bnb-opbnb-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); [​](https://goldrush.dev/docs/chains/opbnb#foundational-api-support) Foundational API Support ------------------------------------------------------------------------------------------------ This chain supports **22** GoldRush Foundational APIs: #### [​](https://goldrush.dev/docs/chains/opbnb#wallet-api) Wallet API * **[Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) ** * **[Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ** * **[Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ** * **[Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ** #### [​](https://goldrush.dev/docs/chains/opbnb#pricing-api) Pricing API * **[Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ** #### [​](https://goldrush.dev/docs/chains/opbnb#security-api) Security API * **[Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) ** #### [​](https://goldrush.dev/docs/chains/opbnb#activity-feed-api) Activity Feed API * **[Get a transaction](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction) ** * **[Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ** * **[Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) ** * **[Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ** * **[Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ** * **[Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ** * **[Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ** * **[Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ** #### [​](https://goldrush.dev/docs/chains/opbnb#block-explorer-api) Block Explorer API * **[Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ** * **[Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ** * **[Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ** * **[Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ** * **[Get gas prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices) ** * **[Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ** * **[Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) ** * **[Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ** [​](https://goldrush.dev/docs/chains/opbnb#additional-resources) Additional Resources ---------------------------------------------------------------------------------------- * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/) * [AppChain Documentation](https://goldrush.dev/docs/appchains/) [Blast](https://goldrush.dev/docs/chains/blast) [Canto](https://goldrush.dev/docs/chains/canto) ⌘I --- # Get activity across all chains for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Cross Chain Get activity across all chains for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getAddressActivity({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "address": "", "items": [\ {\ "extends": {\ "name": "",\ "chain_id": "",\ "is_testnet": true,\ "db_schema_name": "",\ "label": "",\ "category_label": "",\ "logo_url": "",\ "black_logo_url": "",\ "white_logo_url": "",\ "color_theme": {\ "red": 123,\ "green": 123,\ "blue": 123,\ "alpha": 123,\ "hex": "",\ "css_rgb": ""\ },\ "is_appchain": true,\ "appchain_of": {}\ },\ "last_seen_at": "2023-11-07T05:31:56Z"\ }\ ] } GET / v1 / address / {walletAddress} / activity Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getAddressActivity({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "address": "", "items": [\ {\ "extends": {\ "name": "",\ "chain_id": "",\ "is_testnet": true,\ "db_schema_name": "",\ "label": "",\ "category_label": "",\ "logo_url": "",\ "black_logo_url": "",\ "white_logo_url": "",\ "color_theme": {\ "red": 123,\ "green": 123,\ "blue": 123,\ "alpha": 123,\ "hex": "",\ "css_rgb": ""\ },\ "is_appchain": true,\ "appchain_of": {}\ },\ "last_seen_at": "2023-11-07T05:31:56Z"\ }\ ] } Credit Cost ----------- 0.5 per call Processing ---------- Realtime Related guides [Calculate Crypto Cost Basis and Capital Gains with GoldRush](https://goldrush.dev/guides/calculate-crypto-cost-basis-and-capital-gains-with-covalent) [DIY - Build Your Own Crypto Tax Calculator with Google Sheets](https://goldrush.dev/guides/diy-build-your-own-crypto-tax-calculator-with-google-sheets) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#parameter-wallet-address) walletAddress string required The requested wallet address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#parameter-testnets) testnets boolean Set to true to include testnets with activity in the response. By default, it's set to `false` and only returns mainnet activity. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-address-activity#response-items) items object\[\] List of response items. Show child attributes [Authentication](https://goldrush.dev/docs/goldrush-foundational-api/authentication) [Get multichain balances](https://goldrush.dev/docs/api-reference/foundational-api/cross-chain/get-allchains-balances) ⌘I --- # Get Bitcoin balances for HD address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Bitcoin Get Bitcoin balances for HD address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/btc-mainnet/address/{walletAddress}/hd_wallets/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "child_address": "",\ "address_path": "",\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "contract_display_name": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "logo_urls": {\ "token_logo_url": "",\ "protocol_logo_url": "",\ "chain_logo_url": ""\ },\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "balance_24h": "",\ "quote_rate": 123,\ "quote_rate_24h": 123,\ "quote": 123,\ "quote_24h": 123,\ "pretty_quote": "",\ "pretty_quote_24h": "",\ "protocol_metadata": {\ "protocol_name": ""\ },\ "nft_data": ""\ }\ ] } GET / v1 / btc-mainnet / address / {walletAddress} / hd\_wallets Try it cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/btc-mainnet/address/{walletAddress}/hd_wallets/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "child_address": "",\ "address_path": "",\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "contract_display_name": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "logo_urls": {\ "token_logo_url": "",\ "protocol_logo_url": "",\ "chain_logo_url": ""\ },\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "balance_24h": "",\ "quote_rate": 123,\ "quote_rate_24h": 123,\ "quote": 123,\ "quote_24h": 123,\ "pretty_quote": "",\ "pretty_quote_24h": "",\ "protocol_metadata": {\ "protocol_name": ""\ },\ "nft_data": ""\ }\ ] } Credit Cost ----------- 0.1 per item Processing ---------- Realtime Requests that return status 200 and no data cost 0.1 credits. Related guides [What are Deterministic Wallets and How They Work?](https://goldrush.dev/guides/what-are-deterministic-wallets-and-how-they-work) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#parameter-wallet-address) walletAddress string required The extended public key (xPub/yPub/zPub) of the HD wallet. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#parameter-quote-currency) quote-currency string The currency to convert the balance to. Supports `USD`, `CAD`, `EUR`, etc. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-address) address string The extended public key (xPub/yPub/zPub) or HD wallet address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-chain-id) chain\_id integer The requested chain ID eg: `20090103`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-chain-name) chain\_name string The requested chain name eg: `btc-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address#response-items) items object\[\] List of HD wallet balance items, each containing derived addresses and balances. Show child attributes [Get token approvals for address](https://goldrush.dev/docs/api-reference/foundational-api/security/get-token-approvals-for-address) [Get Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address) ⌘I --- # Get historical Bitcoin balance for non-HD address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Bitcoin Get historical Bitcoin balance for non-HD address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getHistoricalBitcoinBalanceForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "block_height": 123,\ "last_transferred_block_height": 123,\ "contract_display_name": "",\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "quote_rate": 123,\ "quote": 123,\ "pretty_quote": "",\ "protocol_metadata": {\ "protocol_name": ""\ },\ "nft_data": [\ {\ "token_id": "",\ "token_balance": "",\ "token_url": "",\ "supports_erc": [\ ""\ ],\ "token_price_wei": "",\ "token_quote_rate_eth": "",\ "original_owner": "",\ "external_data": {\ "name": "",\ "description": "",\ "image": "",\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "animation_url": "",\ "external_url": "",\ "attributes": [\ {\ "trait_type": "",\ "value": ""\ }\ ],\ "thumbnails": {\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "image_opengraph_url": "",\ "thumbhash": ""\ },\ "image_preview": "",\ "asset_properties": {\ "asset_width": 123,\ "asset_height": 123,\ "dominant_color": ""\ },\ "owner": ""\ },\ "owner": "",\ "owner_address": "",\ "burned": true\ }\ ]\ }\ ] } GET / v1 / btc-mainnet / address / {walletAddress} / historical\_balances Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getHistoricalBitcoinBalanceForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "block_height": 123,\ "last_transferred_block_height": 123,\ "contract_display_name": "",\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "quote_rate": 123,\ "quote": 123,\ "pretty_quote": "",\ "protocol_metadata": {\ "protocol_name": ""\ },\ "nft_data": [\ {\ "token_id": "",\ "token_balance": "",\ "token_url": "",\ "supports_erc": [\ ""\ ],\ "token_price_wei": "",\ "token_quote_rate_eth": "",\ "original_owner": "",\ "external_data": {\ "name": "",\ "description": "",\ "image": "",\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "animation_url": "",\ "external_url": "",\ "attributes": [\ {\ "trait_type": "",\ "value": ""\ }\ ],\ "thumbnails": {\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "image_opengraph_url": "",\ "thumbhash": ""\ },\ "image_preview": "",\ "asset_properties": {\ "asset_width": 123,\ "asset_height": 123,\ "dominant_color": ""\ },\ "owner": ""\ },\ "owner": "",\ "owner_address": "",\ "burned": true\ }\ ]\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#parameter-wallet-address) walletAddress string required Only Bitcoin non-HD addresses are supported. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#parameter-block-height) block-height integer Ending block to define a block range. Omitting this parameter defaults to the latest block height. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#parameter-date) date string Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address#response-items) items object\[\] List of response items. Show child attributes [Get Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address) [Get Bitcoin transactions for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address) ⌘I --- # Get Bitcoin transactions for non-HD address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Bitcoin Get Bitcoin transactions for non-HD address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/cq/covalent/app/bitcoin/transactions/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "chain_id": 123,\ "chain_name": "",\ "contract_decimals": 123,\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_idx": 123,\ "type": "",\ "address": "",\ "value": "",\ "quote": 123,\ "quote_rate": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "gas_quote_rate": 123,\ "coinbase": true,\ "locktime": 123,\ "weight": 123\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } GET / v1 / cq / covalent / app / bitcoin / transactions Try it cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/cq/covalent/app/bitcoin/transactions/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "chain_id": 123,\ "chain_name": "",\ "contract_decimals": 123,\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_idx": 123,\ "type": "",\ "address": "",\ "value": "",\ "quote": 123,\ "quote_rate": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "gas_quote_rate": 123,\ "coinbase": true,\ "locktime": 123,\ "weight": 123\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } Credit Cost ----------- 0.1 per item Processing ---------- Realtime Only supports non-HD bitcoin addresses. #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#parameter-address) address string The bitcoin address to query. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#parameter-page-size) page-size integer Number of items per page. Omitting this parameter defaults to 100. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#parameter-page-number) page-number integer 0-indexed page number to begin pagination. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#response-items) items object\[\] List of response items. Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address#response-pagination) pagination object Pagination metadata. Show child attributes [Get historical Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-bitcoin-balance-for-address) [Get historical token prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices) ⌘I --- # Get resolved address for registered address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get resolved address for registered address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getResolvedAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "address": "",\ "name": ""\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / resolve\_address Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getResolvedAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "address": "",\ "name": ""\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime Related guides [How to Resolve a Wallet Address Given an ENS Domain](https://goldrush.dev/guides/how-to-resolve-a-wallet-address-given-an-ens-domain) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address#response-items) items object\[\] List of response items. Show child attributes [Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) [Enhanced Bitcoin Support](https://goldrush.dev/docs/resources/enhanced-bitcoin-support) ⌘I --- # Page Not Found [Skip to main content](https://goldrush.dev/docs/goldrush-foundational-api/goldrush-sdks#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Page Not Found [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) 404 Page Not Found ============== We couldn't find the page. Maybe you were looking for one of these pages below? [GoldRush SDKs](https://goldrush.dev/docs/goldrush-sdks#) [What is GoldRush](https://goldrush.dev/docs/overview#what-is-goldrush) [Overview](https://goldrush.dev/docs/goldrush-foundational-api/overview#) ⌘I --- # Get native token balance for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Balances Get native token balance for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getNativeTokenBalance({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "block_height": 123,\ "balance": "",\ "quote_rate": 123,\ "quote": 123,\ "pretty_quote": ""\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / balances\_native Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getNativeTokenBalance({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "block_height": 123,\ "balance": "",\ "quote_rate": 123,\ "quote": 123,\ "pretty_quote": ""\ }\ ] } Credit Cost ----------- 0.5 per call Processing ---------- Realtime Not supported on non-EVM chains such as Bitcoin and Solana. Related guides [Building a Web3 Portfolio Tracker with the GoldRush API](https://goldrush.dev/guides/building-a-web3-portfolio-tracker-with-the-covalent-api) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#parameter-block-height) block-height integer Ending block to define a block range. Omitting this parameter defaults to the latest block height. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance#response-items) items object\[\] List of response items. Show child attributes [Get historical token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address) [Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) ⌘I --- # Get historical token prices - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Prices Get historical token prices [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.PricingService.getTokenPrices({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "contract_decimals": 123, "contract_name": "", "contract_ticker_symbol": "", "contract_address": "", "supports_erc": [\ ""\ ], "logo_url": "", "update_at": "2023-11-07T05:31:56Z", "quote_currency": "", "logo_urls": { "token_logo_url": "", "protocol_logo_url": "", "chain_logo_url": "" }, "prices": [\ {\ "contract_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "date": "2023-11-07T05:31:56Z",\ "price": 123,\ "pretty_price": ""\ }\ ], "items": [\ {}\ ] } GET / v1 / pricing / historical\_by\_addresses\_v2 / {chainName} / {quoteCurrency} / {contractAddress} Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.PricingService.getTokenPrices({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "contract_decimals": 123, "contract_name": "", "contract_ticker_symbol": "", "contract_address": "", "supports_erc": [\ ""\ ], "logo_url": "", "update_at": "2023-11-07T05:31:56Z", "quote_currency": "", "logo_urls": { "token_logo_url": "", "protocol_logo_url": "", "chain_logo_url": "" }, "prices": [\ {\ "contract_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "date": "2023-11-07T05:31:56Z",\ "price": 123,\ "pretty_price": ""\ }\ ], "items": [\ {}\ ] } Credit Cost ----------- 1 per call Processing ---------- Batch Supports a comma separated list of token contract addresses.If no date range is provided, the spot price (with a 5 minute refresh) is provided. #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#parameter-quote-currency) quoteCurrency string required The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#parameter-contract-address) contractAddress string required Contract address for the token. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. Supports multiple contract addresses separated by commas. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#parameter-from) from string The start day of the historical price range (YYYY-MM-DD). [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#parameter-to) to string The end day of the historical price range (YYYY-MM-DD). [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#parameter-prices-at-asc) prices-at-asc boolean Sort the prices in chronological ascending order. By default, it's set to `false` and returns prices in chronological descending order. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-contract-decimals) contract\_decimals integer Use contract decimals to format the token balance for display purposes - divide the balance by `10^{contract_decimals}`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-contract-name) contract\_name string The string returned by the `name()` method. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-contract-ticker-symbol) contract\_ticker\_symbol string The ticker symbol for this contract. This field is set by a developer and non-unique across a network. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-contract-address) contract\_address string Use the relevant `contract_address` to lookup prices, logos, token transfers, etc. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-supports-erc) supports\_erc string\[\] A list of supported standard ERC interfaces, eg: `ERC20` and `ERC721`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-logo-url) logo\_url string The contract logo URL. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-update-at) update\_at string [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-logo-urls) logo\_urls object The contract logo URLs. Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-prices) prices object\[\] List of response items. Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-historical-token-prices#response-items) items object\[\] List of response items. [Get Bitcoin transactions for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address) [Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) ⌘I --- # Get historical portfolio value over time - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Balances Get historical portfolio value over time [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getHistoricalPortfolioForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "contract_address": "",\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "logo_url": "",\ "holdings": [\ {\ "quote_rate": 123,\ "timestamp": "2023-11-07T05:31:56Z",\ "close": {\ "balance": "",\ "quote": 123,\ "pretty_quote": ""\ },\ "high": {},\ "low": {},\ "open": {}\ }\ ]\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / portfolio\_v2 Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getHistoricalPortfolioForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "items": [\ {\ "contract_address": "",\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "logo_url": "",\ "holdings": [\ {\ "quote_rate": 123,\ "timestamp": "2023-11-07T05:31:56Z",\ "close": {\ "balance": "",\ "quote": 123,\ "pretty_quote": ""\ },\ "high": {},\ "low": {},\ "open": {}\ }\ ]\ }\ ] } Credit Cost ----------- 2 per 30 days Processing ---------- Realtime Related guides [How to Build a 30-Day Historical Crypto Portfolio Chart](https://goldrush.dev/guides/how-to-build-a-30-day-historic-crypto-portfolio-chart) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#parameter-days) days integer The number of days to return data for. Defaults to 30 days. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time#response-items) items object\[\] List of response items. Show child attributes [Get ERC20 token transfers for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address) [Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) ⌘I --- # Get ERC20 token transfers for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Balances Get ERC20 token transfers for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getErc20TransfersForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "miner_address": "",\ "from_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "transfers": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "tx_hash": "",\ "from_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "logo_url": "",\ "transfer_type": "",\ "delta": "",\ "balance": "",\ "quote_rate": 123,\ "delta_quote": 123,\ "pretty_delta_quote": "",\ "balance_quote": 123,\ "method_calls": [\ {\ "sender_address": "",\ "method": ""\ }\ ],\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ]\ }\ ]\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } GET / v1 / {chainName} / address / {walletAddress} / transfers\_v2 Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getErc20TransfersForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "miner_address": "",\ "from_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "transfers": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "tx_hash": "",\ "from_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "logo_url": "",\ "transfer_type": "",\ "delta": "",\ "balance": "",\ "quote_rate": 123,\ "delta_quote": 123,\ "pretty_delta_quote": "",\ "balance_quote": 123,\ "method_calls": [\ {\ "sender_address": "",\ "method": ""\ }\ ],\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ]\ }\ ]\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } Credit Cost ----------- 0.05 per item Processing ---------- Realtime Related guides [Understanding Web3 Wallets with GoldRush](https://goldrush.dev/guides/understanding-web3-wallets) [Calculate Crypto Cost Basis and Capital Gains with GoldRush](https://goldrush.dev/guides/calculate-crypto-cost-basis-and-capital-gains-with-covalent) [DIY - Build Your Own Crypto Tax Calculator with Google Sheets](https://goldrush.dev/guides/diy-build-your-own-crypto-tax-calculator-with-google-sheets) [How to Use Covalent’s Wallet Transaction Analysis Tool](https://goldrush.dev/guides/how-to-use-covalent-s-wallet-transaction-analysis-tool) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-contract-address) contract-address string required The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-starting-block) starting-block integer The block height to start from, defaults to `0`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-ending-block) ending-block integer The block height to end at, defaults to current block height. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-page-size) page-size integer Number of items per page. Omitting this parameter defaults to 100. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#parameter-page-number) page-number integer 0-indexed page number to begin pagination. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-items) items object\[\] List of response items. Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address#response-pagination) pagination object Pagination metadata. Show child attributes [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) [Get historical portfolio value over time](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time) ⌘I --- # Get a transaction - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get a transaction [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getTransaction({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ],\ "internal_transfers": [\ {\ "from_address": "",\ "to_address": "",\ "value": "",\ "gas_limit": 123\ }\ ],\ "state_changes": [\ {\ "address": "",\ "balance_before": "",\ "balance_after": "",\ "storage_changes": [\ {\ "storage_address": "",\ "value_before": "",\ "value_after": ""\ }\ ],\ "nonce_before": 123,\ "nonce_after": 123\ }\ ],\ "input_data": {\ "method_id": ""\ }\ }\ ] } GET / v1 / {chainName} / transaction\_v2 / {txHash} Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getTransaction({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ],\ "internal_transfers": [\ {\ "from_address": "",\ "to_address": "",\ "value": "",\ "gas_limit": 123\ }\ ],\ "state_changes": [\ {\ "address": "",\ "balance_before": "",\ "balance_after": "",\ "storage_changes": [\ {\ "storage_address": "",\ "value_before": "",\ "value_after": ""\ }\ ],\ "nonce_before": 123,\ "nonce_after": 123\ }\ ],\ "input_data": {\ "method_id": ""\ }\ }\ ] } Credit Cost ----------- 0.1 per call Processing ---------- Realtime Base cost is `0.1` credits (e.g. requests that return with status `200` but no items).Calls with `no-logs` cost `0.05` credits/item.The following tracing features each cost `0.05` credits where available on [Foundational Chains](https://goldrush.dev/chains) : * `with-internal` - includes internal transfers/transactions. * `with-state` - includes all transaction state changes with before and after values. * `with-input-data` - includes the transaction’s input data such as the Method ID. Currently, tracing features are supported on the following chains: * `eth-mainnet` Related guides [How to Get the Latest Axie Spawns](https://goldrush.dev/guides/how-to-get-the-latest-axie-spawns) [Understanding Different Types of Blockchain Transactions with Covalent](https://goldrush.dev/guides/understanding-blockchain-transactions-with-covalent) [Comparing GoldRush’s Transactions API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) [How to Get Transaction History for an Address on Ethereum](https://goldrush.dev/guides/how-to-get-transaction-history-for-an-address-on-ethereum) [How to Fetch User Operations (UserOps) for a Specific Wallet Address](https://goldrush.dev/guides/how-to-fetch-user-operations-userops-for-a-specific-wallet-address) [A Guide to DeFi Taxes](https://goldrush.dev/guides/guide-to-defi-taxes) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#parameter-tx-hash) txHash string required The transaction hash. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#parameter-no-logs) no-logs boolean Omit log events. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#parameter-with-internal) with-internal boolean Whether to include internal transfers/transactions. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#parameter-with-state) with-state boolean Whether to include all transaction state changes with before and after values. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#parameter-with-input-data) with-input-data boolean Whether to include the transaction's input data such as the Method ID. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-a-transaction#response-items) items object\[\] List of response items. Show child attributes [Get token holders as of any block height (v2)](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2) [Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) ⌘I --- # Get all transactions in a block by page (v3) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get all transactions in a block by page (v3) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } GET / v1 / {chainName} / block / {blockHeight} / transactions\_v3 / page / {page} Try it cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/block/{blockHeight}/transactions_v3/page/{page}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } Credit Cost ----------- 0.1 per item Processing ---------- Realtime #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#parameter-block-height) blockHeight integer required The requested block height. Also accepts `latest` to get latest block. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#parameter-page) page integer required The requested 0-indexed page number. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#parameter-no-logs) no-logs boolean Omit log events. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#response-links) links object Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page#response-items) items object\[\] List of response items. Show child attributes [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) [Get all transactions in a block (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block) ⌘I --- # Get earliest transactions for address (v3) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get earliest transactions for address (v3) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "complete": true, "current_bucket": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } GET / v1 / {chainName} / bulk / transactions / {walletAddress} Try it cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "complete": true, "current_bucket": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } Credit Cost ----------- 0.1 per item Processing ---------- Realtime Returns the same results as the first timebucket for an address in the [Get recent transactions](https://goldrush.dev/docs/api/transactions/get-recent-transactions-for-address-v3/) endpoint.Requests that return status 200 and no data cost 0.1 credits.Enabling `no-logs` reduces request cost to 0.05 per item. Related guides [Introducing Transactions V3 APIs](https://goldrush.dev/guides/introducing-transactions-v3-apis) [Comparing GoldRush’s Transactions API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) [How to Get Transaction History for an Address on Ethereum](https://goldrush.dev/guides/how-to-get-transaction-history-for-an-address-on-ethereum) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#parameter-no-logs) no-logs boolean Omit log events. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-complete) complete boolean [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-current-bucket) current\_bucket integer The current bucket of the response. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-links) links object Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3#response-items) items object\[\] List of response items. Show child attributes [Get transaction summary for address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address) [Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) ⌘I --- # Get all chain statuses - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get all chain statuses [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getAllChainStatus({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "name": "",\ "chain_id": "",\ "is_testnet": true,\ "logo_url": "",\ "black_logo_url": "",\ "white_logo_url": "",\ "is_appchain": true,\ "synced_block_height": 123,\ "synced_blocked_signed_at": "2023-11-07T05:31:56Z",\ "has_data": true\ }\ ] } GET / v1 / chains / status Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getAllChainStatus({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "name": "",\ "chain_id": "",\ "is_testnet": true,\ "logo_url": "",\ "black_logo_url": "",\ "white_logo_url": "",\ "is_appchain": true,\ "synced_block_height": 123,\ "synced_blocked_signed_at": "2023-11-07T05:31:56Z",\ "has_data": true\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses#response-items) items object\[\] List of response items. Show child attributes [Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) [Get resolved address for registered address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-resolved-address-for-registered-address) ⌘I --- # Get all chains - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get all chains [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getAllChains({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "name": "",\ "chain_id": "",\ "is_testnet": true,\ "db_schema_name": "",\ "label": "",\ "category_label": "",\ "logo_url": "",\ "black_logo_url": "",\ "white_logo_url": "",\ "color_theme": {\ "red": 123,\ "green": 123,\ "blue": 123,\ "alpha": 123,\ "hex": "",\ "css_rgb": ""\ },\ "is_appchain": true,\ "appchain_of": {}\ }\ ] } GET / v1 / chains Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getAllChains({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "items": [\ {\ "name": "",\ "chain_id": "",\ "is_testnet": true,\ "db_schema_name": "",\ "label": "",\ "category_label": "",\ "logo_url": "",\ "black_logo_url": "",\ "white_logo_url": "",\ "color_theme": {\ "red": 123,\ "green": 123,\ "blue": 123,\ "alpha": 123,\ "hex": "",\ "css_rgb": ""\ },\ "is_appchain": true,\ "appchain_of": {}\ }\ ] } Credit Cost ----------- 0.01 per call Processing ---------- Realtime #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains#response-items) items object\[\] List of response items. Show child attributes [Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) [Get all chain statuses](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chain-statuses) ⌘I --- # Get a block - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get a block [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getBlock({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "block_hash": "",\ "signed_at": "2023-11-07T05:31:56Z",\ "height": 123,\ "block_parent_hash": "",\ "extra_data": "",\ "miner_address": "",\ "mining_cost": 123,\ "gas_used": 123,\ "gas_limit": 123,\ "transactions_link": ""\ }\ ] } GET / v1 / {chainName} / block\_v2 / {blockHeight} Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getBlock({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "block_hash": "",\ "signed_at": "2023-11-07T05:31:56Z",\ "height": 123,\ "block_parent_hash": "",\ "extra_data": "",\ "miner_address": "",\ "mining_cost": 123,\ "gas_used": 123,\ "gas_limit": 123,\ "transactions_link": ""\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#parameter-block-height) blockHeight string required The block height or `latest` for the latest block available. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block#response-items) items object\[\] List of response items. Show child attributes [Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) [Get block heights](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights) ⌘I --- # Get all transactions in a block (v3) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get all transactions in a block (v3) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getTransactionsForBlockHash({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } GET / v1 / {chainName} / block\_hash / {blockHash} / transactions\_v3 Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getTransactionsForBlockHash({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } Credit Cost ----------- 0.1 per item Processing ---------- Realtime Related guides [Introducing Transactions V3 APIs](https://goldrush.dev/guides/introducing-transactions-v3-apis) [Building Block Explorers (Part 1) - Multi-chain Block Transaction Explorer](https://goldrush.dev/guides/building-block-explorers-part-1-multi-chain-block-transaction-explorer) [Comparing GoldRush’s Transactions API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) [How to Track Wallets or Transactions with the GoldRush API](https://goldrush.dev/guides/how-to-flag-interesting-wallets-and-or-transactions) [How to Get the Number of Transactions in a Block](https://goldrush.dev/guides/how-to-get-the-number-of-transactions-in-a-block) [How to Get All Historical Transactions in a Block](https://goldrush.dev/guides/how-to-get-all-historical-transactions-in-a-block) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#parameter-block-hash) blockHash string required The requested block hash. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#parameter-no-logs) no-logs boolean Omit log events. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block#response-items) items object\[\] List of response items. Show child attributes [Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) [Get NFTs for address](https://goldrush.dev/docs/api-reference/foundational-api/nft/get-nfts-for-address) ⌘I --- # Get paginated transactions for address (v3) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get paginated transactions for address (v3) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "current_page": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / transactions\_v3 / page / {page} Try it cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/address/{walletAddress}/transactions_v3/page/{page}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "current_page": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } Credit Cost ----------- 0.1 per item Processing ---------- Realtime This endpoint returns paginated transactions, starting with the earliest transactions on page 0. For the most recent transactions, refer to the [Get recent transactions for address (v3)](https://www.covalenthq.com/docs/api/transactions/get-recent-transactions-for-address-v3/) endpoint.Requests that return status 200 and no data cost 0.1 credits.Enabling `no-logs` reduces request cost to 0.05 per item. Related guides [Introducing Transactions V3 APIs](https://goldrush.dev/guides/introducing-transactions-v3-apis) [Calculate Crypto Cost Basis and Capital Gains with GoldRush](https://goldrush.dev/guides/calculate-crypto-cost-basis-and-capital-gains-with-covalent) [Discover Your Ethereum Gas Consumption with the GoldRush API](https://goldrush.dev/guides/ethereum-gas-consumption) [How Token Gating and Membership dApps Use the GoldRush API](https://goldrush.dev/guides/how-token-gating-dapps-use-the-covalent-api) [Comparing GoldRush’s Transactions API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) [How to Get Transaction History for an Address on Ethereum](https://goldrush.dev/guides/how-to-get-transaction-history-for-an-address-on-ethereum) [Getting Started with the GoldRush SDK](https://goldrush.dev/guides/getting-started-with-the-covalent-sdk) [How to Use Covalent’s Wallet Transaction Analysis Tool](https://goldrush.dev/guides/how-to-use-covalent-s-wallet-transaction-analysis-tool) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#parameter-page) page integer required The requested page, 0-indexed. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#parameter-no-logs) no-logs boolean Omit log events. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#parameter-block-signed-at-asc) block-signed-at-asc boolean Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-current-page) current\_page integer The current page of the response. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-links) links object Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3#response-items) items object\[\] List of response items. Show child attributes [Get recent transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3) [Get bulk time bucket transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3) ⌘I --- # Get recent transactions for address (v3) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get recent transactions for address (v3) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getRecentTransactionsForAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "current_page": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / transactions\_v3 Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.TransactionService.getRecentTransactionsForAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "current_page": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } Credit Cost ----------- 0.1 per item Processing ---------- Realtime Requests that return status 200 and no data cost 0.1 credits.Enabling `no-logs` reduces request cost to 0.05 per item. Related guides [Introducing Transactions V3 APIs](https://goldrush.dev/guides/introducing-transactions-v3-apis) [Comparing GoldRush’s Transactions API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#parameter-no-logs) no-logs boolean Omit log events. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#parameter-block-signed-at-asc) block-signed-at-asc boolean Sort the transactions in ascending chronological order. By default, it's set to `false` and returns transactions in descending chronological order. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-current-page) current\_page integer The current page of the response. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-links) links object Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3#response-items) items object\[\] List of response items. Show child attributes [Get earliest transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3) [Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) ⌘I --- # Get bulk time bucket transactions for address (v3) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Transactions Get bulk time bucket transactions for address (v3) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "complete": true, "current_bucket": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } GET / v1 / {chainName} / bulk / transactions / {walletAddress} / {timeBucket} Try it cURL cURL Copy Ask AI curl --request GET \ --url https://api.covalenthq.com/v1/{chainName}/bulk/transactions/{walletAddress}/{timeBucket}/ \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "complete": true, "current_bucket": 123, "links": { "prev": "", "next": "" }, "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "block_hash": "",\ "tx_hash": "",\ "tx_offset": 123,\ "successful": true,\ "from_address": "",\ "miner_address": "",\ "from_address_label": "",\ "to_address": "",\ "to_address_label": "",\ "value": "",\ "value_quote": 123,\ "pretty_value_quote": "",\ "gas_metadata": {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": ""\ },\ "gas_offered": 123,\ "gas_spent": 123,\ "gas_price": 123,\ "fees_paid": "",\ "gas_quote": 123,\ "pretty_gas_quote": "",\ "gas_quote_rate": 123,\ "explorers": [\ {\ "label": "",\ "url": ""\ }\ ],\ "log_events": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ]\ }\ ] } Credit Cost ----------- 0.1 per item Processing ---------- Realtime Requests that return status 200 and no data cost 0.1 credits.Enabling `no-logs` reduces request cost to 0.05 per item. Related guides [Scaling Transactions API with Time Buckets](https://goldrush.dev/guides/scaling-transactions-time-buckets) [Introducing Transactions V3 APIs](https://goldrush.dev/guides/introducing-transactions-v3-apis) [How to Get the Earliest Transaction History for an Address on Ethereum](https://goldrush.dev/guides/how-to-get-the-earliest-transaction-history-for-an-address-on-ethereum) [Comparing GoldRush’s Transactions API to RPC Providers](https://goldrush.dev/guides/comparing-covalent-s-transactions-api-to-rpc-providers) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#parameter-time-bucket) timeBucket integer required The 0-indexed 15-minute time bucket. E.g. 27 Feb 2023 05:23 GMT = 1677475383 (Unix time). 1677475383/900=1863861 timeBucket. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#parameter-no-logs) no-logs boolean Omit log events. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-complete) complete boolean [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-current-bucket) current\_bucket integer The current bucket of the response. [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-links) links object Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3#response-items) items object\[\] List of response items. Show child attributes [Get paginated transactions for address (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3) [Get all transactions in a block by page (v3)](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page) ⌘I --- # Get block heights - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get block heights [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getBlockHeights({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "block_hash": "",\ "signed_at": "2023-11-07T05:31:56Z",\ "height": 123,\ "block_parent_hash": "",\ "extra_data": "",\ "miner_address": "",\ "mining_cost": 123,\ "gas_used": 123,\ "gas_limit": 123,\ "transactions_link": ""\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } GET / v1 / {chainName} / block\_v2 / {startDate} / {endDate} Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getBlockHeights({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "block_hash": "",\ "signed_at": "2023-11-07T05:31:56Z",\ "height": 123,\ "block_parent_hash": "",\ "extra_data": "",\ "miner_address": "",\ "mining_cost": 123,\ "gas_used": 123,\ "gas_limit": 123,\ "transactions_link": ""\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } Credit Cost ----------- 1 per call Processing ---------- Realtime #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#parameter-start-date) startDate string required The start date in YYYY-MM-DD format. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#parameter-end-date) endDate string required The end date in YYYY-MM-DD format or `latest` for the latest block available. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#parameter-page-size) page-size integer Number of items per page. Omitting this parameter defaults to 100. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#parameter-page-number) page-number integer 0-indexed page number to begin pagination. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#response-items) items object\[\] List of response items. Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-block-heights#response-pagination) pagination object Pagination metadata. Show child attributes [Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) [Get all chains](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-all-chains) ⌘I --- # Get gas prices - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Prices Get gas prices [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getGasPrices({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "chain_id": 123, "chain_name": "", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "event_type": "", "gas_quote_rate": 123, "base_fee": "", "items": [\ {\ "gas_price": "",\ "gas_spent": "",\ "gas_quote": 123,\ "other_fees": {\ "l_1_gas_quote": 123\ },\ "total_gas_quote": 123,\ "pretty_total_gas_quote": "",\ "interval": ""\ }\ ] } GET / v1 / {chainName} / event / {eventType} / gas\_prices Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getGasPrices({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "chain_id": 123, "chain_name": "", "quote_currency": "", "updated_at": "2023-11-07T05:31:56Z", "event_type": "", "gas_quote_rate": 123, "base_fee": "", "items": [\ {\ "gas_price": "",\ "gas_spent": "",\ "gas_quote": 123,\ "other_fees": {\ "l_1_gas_quote": 123\ },\ "total_gas_quote": 123,\ "pretty_total_gas_quote": "",\ "interval": ""\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Batch Currently support these event types: `erc20` token transfers, `nativetokens` transfer, and `uniswapv3` swap events. Related guides [How to Fetch Onchain Gas Prices and Estimate Gas Costs](https://goldrush.dev/guides/how-to-fetch-gas-prices-and-estimate-gas-costs) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#parameter-event-type) eventType string required The desired event type to retrieve gas prices for. Supports `erc20` transfer events, `uniswapv3` swap events and `nativetokens` transfers. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-event-type) event\_type string The requested event type. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-gas-quote-rate) gas\_quote\_rate number The exchange rate for the requested quote currency. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-base-fee) base\_fee string b;The lowest gas fee for the latest block height. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-gas-prices#response-items) items object\[\] List of response items. Show child attributes [Get pool spot prices](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-pool-spot-prices) [Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) ⌘I --- # Get log events by topic hash(es) - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get log events by topic hash(es) [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getLogEventsByTopicHash({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } GET / v1 / {chainName} / events / topics / {topicHash} Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getLogEventsByTopicHash({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } Credit Cost ----------- 0.01 per item Processing ---------- Realtime Related guides [How to Fetch User Operations (UserOps) for a Specific Wallet Address](https://goldrush.dev/guides/how-to-fetch-user-operations-userops-for-a-specific-wallet-address) [What are Event Logs?](https://goldrush.dev/guides/evm-event-logs) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#parameter-topic-hash) topicHash string required The endpoint will return event logs that contain this topic hash. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#parameter-starting-block) starting-block integer The first block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#parameter-ending-block) ending-block string The last block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#parameter-secondary-topics) secondary-topics string Additional topic hash(es) to filter on - padded & unpadded address fields are supported. Separate multiple topics with a comma. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#parameter-page-size) page-size integer Number of items per page. Omitting this parameter defaults to 100. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#parameter-page-number) page-number integer 0-indexed page number to begin pagination. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#response-items) items object\[\] List of response items. Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash#response-pagination) pagination object Pagination metadata. Show child attributes [Get logs](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-logs) [Get log events by contract address](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address) ⌘I --- # Get log events by contract address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Utility Get log events by contract address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getLogEventsByAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } GET / v1 / {chainName} / events / address / {contractAddress} Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BaseService.getLogEventsByAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "updated_at": "2023-11-07T05:31:56Z", "chain_id": 123, "chain_name": "", "items": [\ {\ "block_signed_at": "2023-11-07T05:31:56Z",\ "block_height": 123,\ "tx_offset": 123,\ "log_offset": 123,\ "tx_hash": "",\ "raw_log_topics": [\ ""\ ],\ "sender_contract_decimals": 123,\ "sender_name": "",\ "sender_contract_ticker_symbol": "",\ "sender_address": "",\ "sender_address_label": "",\ "sender_logo_url": "",\ "supports_erc": [\ ""\ ],\ "sender_factory_address": "",\ "raw_log_data": "",\ "decoded": {\ "name": "",\ "signature": "",\ "params": [\ {\ "name": "",\ "type": "",\ "indexed": true,\ "decoded": true,\ "value": ""\ }\ ]\ }\ }\ ], "pagination": { "has_more": true, "page_number": 123, "page_size": 123, "total_count": 123 } } Credit Cost ----------- 0.01 per item Processing ---------- Realtime Related guides [What are Event Logs?](https://goldrush.dev/guides/evm-event-logs) #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#parameter-contract-address) contractAddress string required The requested contract address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#parameter-starting-block) starting-block integer The first block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#parameter-ending-block) ending-block string The last block to retrieve log events with. Accepts decimals, hexadecimals, or the strings `earliest` and `latest`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#parameter-page-size) page-size integer Number of items per page. Omitting this parameter defaults to 100. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#parameter-page-number) page-number integer 0-indexed page number to begin pagination. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#response-items) items object\[\] List of response items. Show child attributes [​](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address#response-pagination) pagination object Pagination metadata. Show child attributes [Get log events by topic hash(es)](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash) [Get a block](https://goldrush.dev/docs/api-reference/foundational-api/utility/get-a-block) ⌘I --- # Get historical token balances for address - GoldRush API Documentation [Skip to main content](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#content-area) [GoldRush API Documentation home page![light logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/light.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=97917fde1507b0c14e79b83959fe1160)![dark logo](https://mintcdn.com/goldrush/6Ypq-wkqkJ_JUyHA/logo/dark.svg?fit=max&auto=format&n=6Ypq-wkqkJ_JUyHA&q=85&s=5bd4f921dcc81186bf369e7b33ec5734)](https://goldrush.dev/docs) Search... ⌘K Search... Navigation Balances Get historical token balances for address [Overview](https://goldrush.dev/docs/overview) [Foundational API](https://goldrush.dev/docs/goldrush-foundational-api/overview) [Streaming API](https://goldrush.dev/docs/goldrush-streaming-api/overview) [Chains](https://goldrush.dev/docs/chains/overview) GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getHistoricalTokenBalancesForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "block_height": 123,\ "last_transferred_block_height": 123,\ "contract_display_name": "",\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "quote_rate": 123,\ "quote": 123,\ "pretty_quote": "",\ "protocol_metadata": {\ "protocol_name": ""\ },\ "nft_data": [\ {\ "token_id": "",\ "token_balance": "",\ "token_url": "",\ "supports_erc": [\ ""\ ],\ "token_price_wei": "",\ "token_quote_rate_eth": "",\ "original_owner": "",\ "external_data": {\ "name": "",\ "description": "",\ "image": "",\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "animation_url": "",\ "external_url": "",\ "attributes": [\ {\ "trait_type": "",\ "value": ""\ }\ ],\ "thumbnails": {\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "image_opengraph_url": "",\ "thumbhash": ""\ },\ "image_preview": "",\ "asset_properties": {\ "asset_width": 123,\ "asset_height": 123,\ "dominant_color": ""\ },\ "owner": ""\ },\ "owner": "",\ "owner_address": "",\ "burned": true\ }\ ]\ }\ ] } GET / v1 / {chainName} / address / {walletAddress} / historical\_balances Try it GoldRush SDK TypeScript Copy Ask AI import { GoldRushClient } from "@covalenthq/client-sdk"; const ApiServices = async () => { const client = new GoldRushClient("YOUR_API_KEY"); const resp = await client.BalanceService.getHistoricalTokenBalancesForWalletAddress({chainName: "chainName", walletAddress: "walletAddress"}); console.log(resp.data); }; ApiServices(); 200 Copy Ask AI { "address": "", "updated_at": "2023-11-07T05:31:56Z", "quote_currency": "", "chain_id": 123, "chain_name": "", "chain_tip_height": 123, "chain_tip_signed_at": "2023-11-07T05:31:56Z", "items": [\ {\ "contract_decimals": 123,\ "contract_name": "",\ "contract_ticker_symbol": "",\ "contract_address": "",\ "supports_erc": [\ ""\ ],\ "logo_url": "",\ "block_height": 123,\ "last_transferred_block_height": 123,\ "contract_display_name": "",\ "last_transferred_at": "2023-11-07T05:31:56Z",\ "native_token": true,\ "type": "",\ "is_spam": true,\ "balance": "",\ "quote_rate": 123,\ "quote": 123,\ "pretty_quote": "",\ "protocol_metadata": {\ "protocol_name": ""\ },\ "nft_data": [\ {\ "token_id": "",\ "token_balance": "",\ "token_url": "",\ "supports_erc": [\ ""\ ],\ "token_price_wei": "",\ "token_quote_rate_eth": "",\ "original_owner": "",\ "external_data": {\ "name": "",\ "description": "",\ "image": "",\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "animation_url": "",\ "external_url": "",\ "attributes": [\ {\ "trait_type": "",\ "value": ""\ }\ ],\ "thumbnails": {\ "image_256": "",\ "image_512": "",\ "image_1024": "",\ "image_opengraph_url": "",\ "thumbhash": ""\ },\ "image_preview": "",\ "asset_properties": {\ "asset_width": 123,\ "asset_height": 123,\ "dominant_color": ""\ },\ "owner": ""\ },\ "owner": "",\ "owner_address": "",\ "burned": true\ }\ ]\ }\ ] } Credit Cost ----------- 1 per call Processing ---------- Realtime Supported on all [Foundational Chains](https://goldrush.dev/chains/) . #### Authorizations [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#authorization-authorization) Authorization string header required Bearer authentication header of the form: `Bearer `, where `` is your GoldRush API Key. #### Path Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#parameter-chain-name) chainName string required The chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#parameter-wallet-address) walletAddress string required The requested address. Passing in an `ENS`, `RNS`, `Lens Handle`, or an `Unstoppable Domain` resolves automatically. #### Query Parameters [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#parameter-quote-currency) quote-currency string The currency to convert. Supports `USD`, `CAD`, `EUR`, `SGD`, `INR`, `JPY`, `VND`, `CNY`, `KRW`, `RUB`, `TRY`, `NGN`, `ARS`, `AUD`, `CHF`, and `GBP`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#parameter-no-spam) no-spam boolean If `true`, the suspected spam tokens are removed. Supported on all Foundational Chains. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#parameter-block-height) block-height integer Ending block to define a block range. Omitting this parameter defaults to the latest block height. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#parameter-date) date string Ending date to define a block range (YYYY-MM-DD). Omitting this parameter defaults to the current date. #### Response 200 - application/json Successful response [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-address) address string The requested address. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-updated-at) updated\_at string The timestamp when the response was generated. Useful to show data staleness to users. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-quote-currency) quote\_currency string The requested quote currency eg: `USD`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-chain-id) chain\_id integer The requested chain ID eg: `1`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-chain-name) chain\_name string The requested chain name eg: `eth-mainnet`. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-chain-tip-height) chain\_tip\_height integer The latest block height of the blockchain at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-chain-tip-signed-at) chain\_tip\_signed\_at string The timestamp of the latest signed block at the time this response was provided. [​](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address#response-items) items object\[\] List of response items. Show child attributes [Get token balances for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-token-balances-for-address) [Get native token balance for address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-native-token-balance) ⌘I ---