Base Onchain Data API

Get token balances, transactions, and OHLCV pricing data for Base. 39 endpoints supported.

Overview

Base is Coinbase’s secure, low-cost L2 built on the OP Stack. With native Coinbase integrations and a thriving developer ecosystem, Base is bringing the next billion users onchain.

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.

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

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

Pipeline API

Stream blockchain data directly to your own infrastructure. Push decoded blocks, transactions, event logs, and protocol-specific data into your database, warehouse, queue, or webhook with ABI decoding and SQL transforms built in.

Use cases: Data warehousing, analytics dashboards, ETL pipelines, and backend indexing.

Read docs

Mainnet

Property	Value
Chain Name	base-mainnet (Foundational API) / BASE_MAINNET (Streaming API)
Chain ID	8453
Network Type	Foundational Chain
Support Level	foundational
Block Explorer	Base Explorer
Official Website	Base Website
Native Gas Token	ETH

API Usage

To use this blockchain network in GoldRush API calls, use:

Chain Name

• base-mainnet / BASE_MAINNET (mainnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/base-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

SDK Usage

TypeScript SDK (Mainnet)

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "base-mainnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

Foundational API Support

This chain supports 28 GoldRush Foundational APIs:

Wallet API

• Get token holders as of any block height (v2) on Base
• Get historical token balances for address on Base
• Get token balances for address on Base
• Get native token balance for address on Base
• Get historical portfolio value over time on Base
• Get ERC20 token transfers for address on Base

NFT API

• Get NFTs for address on Base
• Check ownership in NFT collection on Base
• Check ownership in NFT collection for specific token on Base

Pricing API

• Get pool spot prices on Base
• Get historical token prices on Base

Security API

• Get token approvals for address on Base

Transactions API

• Get a transaction on Base with-traces
• Get transaction summary for address on Base
• Get earliest transactions for address (v3) on Base with-traces
• Get recent transactions for address (v3) on Base with-traces
• Get paginated transactions for address (v3) on Base with-traces
• Get bulk time bucket transactions for address (v3) on Base
• Get all transactions in a block (v3) on Base
• Get all transactions in a block by page (v3) on Base

Block Explorer API

• Get a block on Base
• Get all chain statuses on Base
• Get all chains on Base
• Get block heights on Base
• Get gas prices on Base
• Get log events by contract address on Base
• Get log events by topic hash(es) on Base
• Get logs on Base

Streaming API Support

This chain supports 11 GoldRush Streaming APIs:

• New DEX Pairs Stream on Base
• OHLCV Pairs Stream on Base
• OHLCV Tokens Stream on Base
• Update Pairs Stream on Base
• Update Tokens Stream on Base
• Wallet Activity Stream on Base
• OHLCV Pairs Query on Base
• OHLCV Tokens Query on Base
• Token Search Query on Base
• Top Trader Wallets for Token Query on Base
• Wallet PnL by Token Query on Base

Pipeline API Support

This chain supports 7 GoldRush Pipeline API data objects that can be streamed to your infrastructure:

• Blocks
• Traces
• Transactions
• Logs
• Receipts
• Transfers
• Swaps

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference