Wallet Balance API - GoldRush Tokens, Transactions and NFTs

Export wallet token balances, decoded transaction history, NFT holdings, token holders, contract event logs and historical portfolio value across 100+ blockchains into an Apify dataset with your own GoldRush API key.

Works with the GoldRush Foundational API from Covalent (api.covalenthq.com/v1). The actor turns a list of wallet, token or contract addresses and a list of chains into clean, deduplicated rows you can download as JSON, CSV or Excel, schedule daily, or feed into portfolio trackers, tax and accounting tools, compliance reviews, dashboards and AI agents. Bring your own API key.

What it does

• Token balances for a wallet: every native and ERC20 token an address holds on Ethereum, Base, Polygon, BNB Smart Chain, Arbitrum, Optimism, Avalanche and 100+ other chains, with spot price, fiat value, 24h change, logo and a spam flag. The raw balance is also scaled by the token's decimals for you.
• Wallet transactions: decoded transaction history (transactions v3), newest first or oldest first, with value, gas, fees, explorer links, decoded log events and optional internal transfers.
• NFT holdings for a wallet: NFT collections and token IDs a wallet holds, with floor prices, metadata, images and attributes, or a fast IDs-only view.
• Token holders: every holder of an ERC20 or NFT token contract with balance and share of supply, at the latest block or at a past block height or date.
• Contract log events: decoded event logs (Transfer, Swap, Approval and more) a contract emitted over a block range.
• Historical portfolio value: a wallet's daily open, high, low and close balance and fiat value per token over the last N days.
• Supported chains and chain status: every chain name and ID GoldRush covers, with sync height and data status.
• Real filters: quote currency (USD, EUR, GBP, JPY and 12 more), spam token removal, NFT metadata toggle, transaction order, omit log events, internal transfers, holder snapshot block or date, starting and ending block.
• Pay only for results: empty lookups and refusals are recorded as a free row that says why, never charged.

How to get an API key

Sign up on the GoldRush platform (goldrush.dev/platform). A free 14 day trial includes 25,000 API credits a month; paid plans start with the Vibe Coding tier (10,000 credits a month) and Professional (300,000 credits, 50 requests a second). Copy your key from the API Keys page and paste it into the API key field, or set the DATA_API_KEY environment secret. This actor never ships a shared key.

Input

Field	Used by	What it does
mode	all	tokenBalances, transactions, nfts, tokenHolders, logEvents, portfolio, chains or chainStatus
addresses	address modes	Wallet addresses (or ENS, RNS, Lens and Unstoppable names); token contracts for token holders; contracts for log events
chainNames	address modes	Chains to read each address on, such as eth-mainnet, base-mainnet, matic-mainnet (default Ethereum)
otherChains	address modes	Any other GoldRush chain name, one per line
quoteCurrency	balances, transactions, portfolio	Fiat currency for prices and values (default USD)
noSpam	balances, NFTs	Remove suspected spam tokens (default on)
noNftMetadata	NFTs	Collections and token IDs only, no metadata
transactionOrder	transactions	newest (default) or oldest first
noLogs, withInternal	transactions	Omit decoded log events; include internal transfers
blockHeight, snapshotDate, noSnapshot	token holders	Historical snapshot block or date; bypass the cached snapshot
startingBlock, endingBlock	log events	Block range: a number, a hex block, earliest or latest
days	portfolio	Days of history (provider default 30)
maxResults	all	Row ceiling for the run (default 100)
requestsPerMinute	all	Pacing to your plan's rate limit (default 120)
apiKey	all	Your GoldRush API key, stored as a secret

Each chain and address pair is its own lookup. An endpoint only receives the parameters its documentation lists; an input that belongs to another mode is left off with a warning.

Example input, token balances of one wallet on Ethereum and Base in EUR:

{
    "mode": "tokenBalances",
    "addresses": ["vitalik.eth"],
    "chainNames": ["eth-mainnet", "base-mainnet"],
    "quoteCurrency": "EUR",
    "noSpam": true,
    "maxResults": 200
}

Example output

A token balance row. The common columns come first; every field the API documents for a balance item follows unchanged.

{
    "mode": "tokenBalances",
    "recordType": "tokenBalance",
    "identifier": "eth-mainnet vitalik.eth",
    "found": true,
    "chainName": "eth-mainnet",
    "queriedAddress": "vitalik.eth",
    "id": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "name": "USDC",
    "value": 1520.42,
    "quoteCurrency": "USD",
    "date": "2026-09-30T14:22:11Z",
    "balanceFormatted": "1520.5",
    "contract_decimals": 6,
    "contract_name": "USD Coin",
    "contract_ticker_symbol": "USDC",
    "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "supports_erc": ["erc20"],
    "is_native_token": false,
    "type": "stablecoin",
    "is_spam": false,
    "balance": "1520500000",
    "balance_24h": "1520500000",
    "quote_rate": 0.99995,
    "quote": 1520.42,
    "pretty_quote": "$1,520.42",
    "note": null
}

Other modes keep their documented fields the same way: transactions carry tx_hash, block_signed_at, from_address, to_address, provider_value (the raw value in wei), value_quote, fees_paid, gas_quote and log_events; holders carry address, balance, total_supply plus balanceFormatted and shareOfSupply; log events carry tx_hash, log_offset, sender_address, raw_log_topics and decoded; portfolio points carry the token fields plus quoteRate, openBalance, closeBalance, closeQuote and the rest of the daily range.

FAQ

What is the GoldRush API?

GoldRush is Covalent's blockchain data API. It indexes 100+ chains, including Ethereum, Base, Polygon, BNB Smart Chain, Arbitrum, Optimism, Avalanche, Bitcoin and Solana, and serves wallet balances, transactions, NFTs, token holders and decoded event logs through one REST interface.

Do I need my own API key?

Yes. The actor reads the GoldRush API with your own key. A run without a key ends straight away with a message that says where to get one, and nothing is charged.

How do I get the token balances of a wallet on several chains?

Use the token balances mode, put the wallet address or ENS name in addresses and pick every chain in chainNames. Each chain is read separately and every token becomes its own row with price and fiat value.

How do I export a wallet's full transaction history?

Use the wallet transactions mode. Newest first starts from the most recent page and walks back; oldest first starts from the wallet's first transaction. Raise maxResults to read further, and turn on noLogs to halve the provider credit cost when you do not need decoded events.

How do I list the holders of a token at a past date?

Use the token holders mode with the token contract in addresses and a snapshotDate or blockHeight. Historical snapshots are served on the GoldRush Foundational Chains (Ethereum, Polygon, BSC, Optimism, Base, Gnosis, Arbitrum, Avalanche and others).

Which chain names can I use?

The dropdown covers the most used chains. Run the supported chains mode for every chain name and ID, and put any of them in otherChains.

What do I pay?

Pay per result: 0.005 USD per token balance, NFT collection, token holder, portfolio point or chain record, and 0.008 USD per decoded transaction or log event. Empty lookups and refusals are never charged. Your GoldRush plan's own API credits are used separately.

What happens if my key is wrong or my credits run out?

A rejected key (HTTP 401) or spent credits end the run cleanly with a status message that explains what to change. Rate limits (HTTP 429) are waited out and retried. A chain or address the API refuses (HTTP 400 or 404) becomes a free row with the API's own words, and the run moves on.

Keyword map

wallet balance API, token balances API, ERC20 balance checker, crypto portfolio tracker, wallet transaction history export, decoded transactions, NFT holdings API, NFT wallet API, token holders list, token holder snapshot, contract event logs, decoded event logs, historical portfolio value, multichain blockchain data API, Ethereum, Base, Polygon, BNB Smart Chain, Arbitrum, Optimism data, Covalent API, GoldRush API.

Terms and data use

Use of the GoldRush API is governed by Covalent's API Terms and GoldRush Terms of Use. They grant a limited, non-exclusive, non-transferable and revocable licence to use the API in your own applications, and they forbid using the API to build a similar or competitive product, reselling or sublicensing access to the service, providing data to a competitor of Covalent, and abusive request volumes. Covalent keeps all rights in its technology and data. Keep the datasets for your own use, and check your GoldRush order form or contact GoldRush sales before redistributing the data. This actor is not affiliated with or endorsed by Covalent.