Skip to main content

Documentation Index

Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
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

https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/foundational.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=8a0b97060449218c1b477fe1fffc8a92

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.
https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/streaming.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=c4a22e003bde989c0cd2d01a67bd6adf

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.
https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/pipeline.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=f0027120a50c03e5660514e94a26cabb

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.

​
Mainnet

PropertyValue
Chain Namebase-mainnet (Foundational API) / BASE_MAINNET (Streaming API)
Chain ID8453
Network TypeFoundational Chain
Support Levelfoundational
Block ExplorerBase Explorer
Official WebsiteBase Website
Native Gas TokenETH

​
Testnet

PropertyValue
Chain Namebase-sepolia-testnet
Chain ID84532
PurposeDevelopment and testing network
Support Levelfoundational
Block ExplorerBase Sepolia Explorer
Official WebsiteBase Sepolia Testnet Website
Native Gas TokenETH

​
API Usage

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

​
Chain Name

  • base-mainnet / BASE_MAINNET (mainnet)
  • base-sepolia-testnet (testnet)

​
Example API Calls

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

​
SDK Usage

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

const client = new GoldRushClient("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

​
NFT API

​
Pricing API

​
Security API

​
Activity Feed API

​
Block Explorer API

​
Streaming API Support

This chain supports 9 GoldRush Streaming APIs:

​
Pipeline API Support

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

​
Additional Resources