Base

Overview

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

Mainnet

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

Testnet

Property	Value
Chain Name	base-sepolia-testnet
Chain ID	84532
Purpose	Development and testing network
Support Level	foundational
Block Explorer	Base Sepolia Explorer
Official Website	Base Sepolia Testnet Website
Native Gas Token	ETH

API Usage

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

Chain Name

• base-mainnet (mainnet)

• base-sepolia-testnet (testnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/base-mainnet/address/demo.eth/balances_v2/?key=API_KEY"

SDK Usage

TypeScript SDK (Mainnet)

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

const client = new GoldRushClient("API_KEY");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "base-mainnet",
    walletAddress: "demo.eth"
});

Foundational API Support

This chain supports 33 GoldRush Foundational APIs:

Wallet API

• Get token holders as of any block height (v2)

Pricing API

• Get pool spot prices
• Get historical token prices

Activity Feed API

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

Block Explorer API

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

Streaming API Support

This chain supports the following GoldRush Streaming APIs:

• Token Balances Stream
• Wallet Activity Stream
• New DEX Pairs Stream
• OHLCV Tokens Stream
• OHLCV Pairs Stream

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference