Crypto wallet API for 100+ chains

Used by Fidelity, ThorWallet and Rainbow

Inside a token balances response

Every token in a token balances response carries about 20 fields. Three of them do most of the work on a wallet screen. Here is one item from the call behind the panel above, and what to do with each.

{  "contract_decimals": 18,1  "contract_name": "Dai Stablecoin",0  "contract_ticker_symbol": "DAI",0  "contract_address": "0x6b175474e89094c44da98b954eedeac495271d0f",0  "supports_erc": ["erc20"],0  "is_native_token": false,0  "type": "stablecoin",0  "is_spam": false,3  "balance": "185374670707837000000",1  "quote_rate": 0.99615,0  "quote_rate_24h": 0.99776,0  "quote": 184.66068,2  "quote_24h": 184.9583,2  "pretty_quote": "$184.66",0  "pretty_quote_24h": "$184.96"0}

Transactions, classified in plain English

Add with-classification=true to a transactions call and every transaction comes back with a type, a category, a one-line description and the assets the wallet sent and received. That is an activity feed without writing a decoder for every protocol.

// data.items[n].classification
{
  "type": "swap",
  "category": "defi",
  "description": "Swapped 872.59 AERO for 0.279091760280112109 WETH.",
  "sent": [
    { "action": "token_sent", "amount": "872.59", "token": { … } },
    { "action": "paid_gas", "amount": "0.0000…", "token": { … } }
  ],
  "received": [
    { "action": "token_received", "amount": "0.2790…", "token": { … } }
  ]
}

# One query parameter on any transactions endpoint
GET /v1/{chainName}/address/{walletAddress}/transactions_v3/
    ?with-classification=true

Wallet data API, screen by screen

Each wallet screen maps to an endpoint or two. Credit costs are per call unless a row says per item.

• Multichain token balances

  Find the chains an address has used in one call, then load its native and token balances with prices in 16 fiat currencies, logos and a spam flag on every token. Fetch up to 10 EVM chains in a single request.

  • Address activity0.5 credits
  • Token balances1 credit
  • Multichain balances2.5 credits

• Wallet transaction history

  Build an activity feed from classified transactions and decoded log events, so swaps, transfers and approvals arrive described, with names and parameters instead of raw topics. Query one chain, or up to 10 addresses on up to 10 chains in one call.

  • Recent transactions0.1 credits per item
  • Transaction classification+0.05 credits per item
  • Cross-chain transactions0.25 credits per item
  • ERC-20 transfers0.05 credits per item

• Portfolio value over time

  Chart what a wallet was worth each day, broken down by token, for 30 days by default or any window you set. Look up a token's price on any date for cost basis and PnL.

  • Historical portfolio value2 credits per 30 days
  • Historical token prices1 credit
  • Historical token balances1 credit

• Token approvals

  List every approval a wallet has granted, grouped by token and spender, with the remaining allowance and the value at risk. That is the data behind a revoke screen or a warning before a risky signature.

  • Token approvals2 credits

• Bitcoin and Solana wallets

  Read Bitcoin balances and transactions for a single address or an HD wallet, and SPL token balances on Solana, with the same API key.

  • Bitcoin balance1 credit
  • Bitcoin HD wallet balances0.1 credits per item
  • Solana wallet endpointsSee reference

Wallet API vs raw JSON-RPC

A node answers one question about one chain per call, and has no index by address. Here is what each wallet screen takes on raw JSON-RPC, and what it takes on GoldRush.

Sources: token balances, multichain balances, transaction history, portfolio value and token approvals.

Start free

Every account starts with a 14-day free trial: 25,000 API credits and 4 requests per second, with no credit card. A token balances call costs 1 credit, so the trial covers 25,000 balance lookups. Paid plans start at $10 a month.