Historical blockchain data API for research

Decoded event logs for any contract or event, token balances and holders at any past block or date, transactions and daily prices, over REST for 100+ chains. Pull exactly the slice a dashboard or a paper needs, from any language, with one API key.

UNI holders on Ethereum31 Dec 2025, block 24,128,884
Holders
386,723
Held by the top 6
47.43%
Largest UNI holders on 31 Dec 2025
AddressSupply
0x1a9c…35bc26.96%
0x0000…dead10.01%
0xf977…acec5.33%
0x61cb…96eb2.30%
0x5069…0f7e1.49%
0x611f…b09d1.33%
One call to token_holders_v2 with date=2025-12-31, 0.02 credits per holder returned.

Used by EY, Fidelity and Consensys

  • EY
  • Fidelity
  • Consensys
  • Jump
  • Ondo
  • ThorWallet
  • Rainbow
  • Matcha
  • Velora
  • AtomicWallet
  • Atlas Wallet
  • OneKey

Inside a token holders response

A token holders response has one item per holder, 10 fields each, and pagination.total_count says how many holders there are: 386,723 for UNI at the end of 2025. Three fields carry a concentration study. Here is one item from the call behind the panel above, and what to do with each.

The response, as JSON
GET/v1/eth-mainnet/tokens/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984/token_holders_v2/?date=2025-12-31
{  "contract_decimals": 18,  "contract_name": "Uniswap",  "contract_ticker_symbol": "UNI",  "contract_address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",  "supports_erc": ["erc20"],  "address": "0x000000000000000000000000000000000000dead",  "balance": "100069579960000000000000000",  "total_supply": "1000000000000000000000000000",  "block_height": 24128884}
one of data.items
One holder from the token_holders_v2 response for UNI on Ethereum with date=2025-12-31, 0.02 credits per holder returned. Captured on 29 Oct 2026; a past date returns the same holders.

Blockchain data for dashboards and research

Each kind of dataset maps to an endpoint or two. Credit costs are per call unless a row says per item.

  • Decoded event logs

    Every event a contract emitted over a block range, or every event with a given signature across all contracts, decoded with names and parameters. That is the raw material for protocol metrics.

  • Holders and balances at any block

    Who held a token on a date, and what any address held then, priced that day. Run the same query at each month end for a panel dataset. Past blocks work on all Foundational chains.

  • Token prices over time

    Daily prices for any token over a date range, in any of 16 fiat currencies, to put event series and balances into USD.

  • Blocks and transactions

    Every transaction in a block, a single transaction with its decoded logs, or an address's full history, oldest first. Classification labels each of an address's transactions with a type and a category, so activity can be counted by kind: swaps, transfers, lending.

Polygon transactions, day by day

Since 9 July 2026, Polygon has settled between 4.52M and 6.75M transactions a day. Tuesdays run busiest; weekends run 7% quieter.

The calendar is one daily series from the GoldRush data warehouse, the same one the GoldRush Polygon dashboard charts. A day with no data stays empty rather than being drawn as a quiet day.

Polygon transactions per day9 July 2026 to 12 October 2026
Busiest day 6.75M on 14 July 2026
Daily rollups from the GoldRush data warehouse. Hover a day for its count.

MCP server and Agent Skills for research

The hosted GoldRush MCP server gives Claude, Cursor and other MCP clients 37 tools, including log_events_by_topic, token_holders, historical_token_balances and historical_token_prices. GoldRush Agent Skills give coding agents the endpoints, parameters and credit costs, so the code they write calls the API correctly. Both work in Claude Code and Cursor, among other agents, and agents without an API key can pay per request in stablecoins on Base through x402.

# MCP server: 37 tools, hosted by GoldRushclaude mcp add --transport http goldrush \  https://mcp.goldrushdata.com/mcp \  --header "Authorization: Bearer $GOLDRUSH_API_KEY" # Agent Skills: Foundational API, x402 and CLInpx skills add covalenthq/goldrush-agent-skills
  • Holder concentration

    Track the share held by a token's top holders at each month end.

  • Event counts

    Count a protocol's swaps or deposits per day from its decoded logs.

  • Price context

    Add daily prices to an event series so every value is in USD.

Historical data API vs Dune

Dune is the place for SQL over whole chains. GoldRush answers narrower questions, about an address, a contract, an event or a block, over REST, including state at any past block.

GoldRush vs Dune
DuneGoldRush
How you querySQL over decoded tablesREST calls by address, contract, event or block
Questions across a whole chainAny SQL you can writeNot the tool for it: one address, contract or event per call
Balances and holders at a past blockLimiteddate or block-height on balances and holders
Chains100+ in SQL100+
Pay per request without an accountNot offered as of 31 May 2026x402, in stablecoins on Base

Sources: GoldRush vs Dune, token holders and log events by topic.

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: 25,000 API credits and 4 requests per second, with no credit card. Log events cost 0.01 credits per item, so the trial covers 2.5 million decoded events. Paid plans start at $10 a month.

Historical data FAQ

Call the GoldRush API for the slice you need: decoded log events by event signature, token holders on a date, or an address's full history. Responses are JSON, so any language or notebook works.

Historical data API docs

Start here

Reference

Compare