GoldRush Foundational API

36 REST endpoints for token balances, transactions, NFTs, blocks, event logs and prices on 100+ chains, all on one API key. Responses include decoded logs, token metadata and USD prices, so you skip the node and the indexer.

Get a free API keyRead the quickstart
API=https://api.covalenthq.com/v1
AUTH="Authorization: Bearer $GOLDRUSH_API_KEY"

# Token balances with USD prices: 1 credit
curl "$API/eth-mainnet/address/0x…/balances_v2/" -H "$AUTH"

# Every chain the same wallet is active on: 0.5 credits
curl "$API/address/0x…/activity/" -H "$AUTH"

# Its NFTs on Base, spam removed: 1 credit
curl "$API/base-mainnet/address/0x…/balances_nft/?no-spam=true" \
  -H "$AUTH"

Used by EY, Fidelity and Consensys

  • EY
  • Fidelity
  • Consensys
  • Jump
  • Ondo
  • ThorWallet
  • Rainbow
  • Matcha
  • Velora
  • AtomicWallet
  • Atlas Wallet
  • OneKey
Read the case studies

Solutions built on the Foundational API

Know what you're building? Each solution page shows the endpoints for it, working together.

Every endpoint, with its credit cost

Some cost credits per call and some per item returned. A dot marks the solutions built on each endpoint.

Foundational API endpoints36 endpoints
GoldRush Foundational API endpoints, their credit costs and the solutions built on each
EndpointCreditsWalletsTaxDeFiRiskTradingResearchStablecoins
Balances
Token balances1 per callUsed by Wallets & PortfolioUsed by DeFi & Onchain FinanceUsed by Stablecoins
Native token balance0.5 per call
Historical token balances1 per callUsed by Wallets & PortfolioUsed by Crypto Tax & AccountingUsed by Risk & ComplianceUsed by Analytics & ResearchUsed by Stablecoins
Historical portfolio value2 per 30 daysUsed by Wallets & Portfolio
ERC-20 token transfers0.05 per itemUsed by Wallets & PortfolioUsed by Crypto Tax & AccountingUsed by Risk & ComplianceUsed by Trading & ExchangesUsed by Stablecoins
Token holders0.02 per itemUsed by Analytics & ResearchUsed by Stablecoins
Transactions
Transaction0.1 per callUsed by Analytics & Research
Recent transactions0.1 per itemUsed by Wallets & PortfolioUsed by DeFi & Onchain FinanceUsed by Risk & ComplianceUsed by Trading & ExchangesUsed by Stablecoins
Paginated transactions0.1 per itemUsed by Crypto Tax & AccountingUsed by Risk & ComplianceUsed by Analytics & Research
Earliest transactions0.1 per item
Time bucket transactions0.1 per item
Transaction summary1 per callUsed by Crypto Tax & AccountingUsed by Risk & Compliance
Cross-chain
Address activity0.5 per callUsed by Wallets & PortfolioUsed by Crypto Tax & AccountingUsed by Risk & Compliance
Multichain balances2.5 per callUsed by Wallets & PortfolioUsed by DeFi & Onchain FinanceUsed by Trading & ExchangesUsed by Stablecoins
Cross-chain transactions0.25 per itemUsed by Wallets & PortfolioUsed by Crypto Tax & AccountingUsed by Risk & Compliance
NFTs on this page: NFT API
NFTs for an address1 per call
NFT collection ownership1 per call
NFT token ownership1 per call
Bitcoin
Bitcoin balance1 per callUsed by Wallets & Portfolio
Bitcoin HD wallet balances0.1 per itemUsed by Wallets & PortfolioUsed by Crypto Tax & Accounting
Historical Bitcoin balance1 per callUsed by Crypto Tax & Accounting
Bitcoin transactions0.1 per itemUsed by Crypto Tax & Accounting
Security
Token approvals2 per callUsed by Wallets & PortfolioUsed by DeFi & Onchain FinanceUsed by Risk & Compliance
Prices
Historical token prices1 per callUsed by Wallets & PortfolioUsed by Crypto Tax & AccountingUsed by DeFi & Onchain FinanceUsed by Trading & ExchangesUsed by Analytics & Research
Pool spot prices1 per callUsed by DeFi & Onchain FinanceUsed by Trading & Exchanges
Blocks and logs on this page: Block explorer API
Block1 per call
Block heights1 per callUsed by Crypto Tax & AccountingUsed by Risk & ComplianceUsed by Analytics & Research
Block transactions0.1 per item
Block transactions by page0.1 per itemUsed by Analytics & Research
Event logs0.01 per item
Log events by contract0.01 per itemUsed by DeFi & Onchain FinanceUsed by Trading & ExchangesUsed by Analytics & ResearchUsed by Stablecoins
Log events by topic0.01 per itemUsed by DeFi & Onchain FinanceUsed by Risk & ComplianceUsed by Analytics & ResearchUsed by Stablecoins
Gas prices1 per call
Chains and names
Supported chains0.01 per call
Chain status1 per call
Name resolution1 per call
Costs from each endpoint's docs page, linked from its name. Some list cheaper options, such as no-logs.

NFT API: holdings and ownership checks

Three endpoints, 1 credit per call each, for wallets that show NFTs and apps that gate on them.

  • NFTs for an address

    Every ERC-721 and ERC-1155 token a wallet holds, with metadata. The no-spam flag drops suspected spam on Foundational Chains.

  • Collection ownership

    Whether a wallet holds anything in a collection, with optional trait and value filters. The check behind token gating.

  • Token ownership

    Whether a wallet holds one specific token ID in a collection, for allowlists and single-item access.

// Token gating: does this wallet hold the collection?
const base = "https://api.covalenthq.com/v1/eth-mainnet";
const url = `${base}/address/${wallet}/collection/${collection}/`;

const res = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
});
const { data } = await res.json();

// 1 credit. items holds the wallet's tokens in the collection.
const holds = data.items.some((t) => Number(t.balance) > 0);

Block explorer API: blocks, logs and gas

The endpoints behind an explorer, an indexer or a backfill job, on every chain the API supports and with the same key.

API=https://api.covalenthq.com/v1/eth-mainnet
AUTH="Authorization: Bearer $GOLDRUSH_API_KEY"

# Date to block number: block heights in a date range
curl "$API/block_v2/2026-10-01/2026-10-02/" -H "$AUTH"

# Every transaction in a block, logs decoded
curl "$API/block/23500000/transactions_v3/page/0/" -H "$AUTH"

# Decoded event logs for 100 blocks: 0.01 credits per log
curl "$API/events/?starting-block=23500000&ending-block=23500100" \
  -H "$AUTH"

# Gas estimates for an ERC-20 transfer, by speed
curl "$API/event/erc20/gas_prices/" -H "$AUTH"

  • Blocks, by height or by date

    One block by height, or every block height between two dates: a date to block number lookup.

    BlockBlock heights

  • Every transaction in a block

    By hash or by height, with decoded logs, or 0.05 credits each with no-logs.

    Block transactions by page

  • Event logs at 0.01 credits each

    Decoded logs for a block range, one contract or one topic hash.

    Event logsLogs by topic

  • Gas prices and names

    Gas estimates by speed, and the address behind an ENS, RNS or Unstoppable Domains name.

    Gas pricesName resolution

Call it from code, a terminal or an agent

  • REST: any HTTP client, with a Bearer token.
  • TypeScript SDK: typed helpers for every endpoint.
  • CLI: 17 commands in your terminal.
  • MCP server: 37 tools for AI agents, hosted by GoldRush.
  • x402: agents pay per request in stablecoins on Base, no key.
import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient(process.env.GOLDRUSH_API_KEY);

const res = await client.BalanceService
  .getTokenBalancesForWalletAddress("eth-mainnet", "demo.eth");

if (!res.error) {
  for (const token of res.data.items) {
    // contract_ticker_symbol, balance, quote (USD value) …
  }
}

Security and SOC 2 compliance

GoldRush is SOC 2 Type 2 compliant. Data is encrypted at rest with AES-256 and in transit with TLS 1.2, and we work with security firms to take down phishing sites and impersonators.

AICPA SOC and SOC 2 Type 2 badges

Start free

Every account starts with a 14-day free trial and 25,000 credits, on the same key for every endpoint above. After that, plans start at $10 a month, and agents can pay per request with x402 instead.

Get a free API keySee pricingEstimate your cost

Foundational API FAQ

A REST API with 36 endpoints for blockchain data on 100+ chains: token balances, transactions, NFTs, blocks, event logs, prices and token approvals. Responses include decoded event logs, token metadata, scaled amounts and USD prices, so you don't run nodes or an indexer. See the overview.

Foundational API docs

Start here

Reference

Costs and tools