Base Onchain Data API

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.

JSON-RPC

Low-latency EVM JSON-RPC with global failover and archive depth. Point your existing tooling at the GoldRush endpoint — no code changes required.

Use cases: dApps, wallets, indexers, bots, and trading infrastructure.

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

API Usage

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

Chain Name

base-mainnet (mainnet)

Example API Calls

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

SDK Usage

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

NFT API

Pricing API

Internal Transactions (`with-internal`)

Base supports internal transactions (traces). The Transactions API endpoints marked with-input-data with-internal above accept the with-internal=true query parameter, which includes internal transactions (the value transfers triggered by contract execution that are not recorded as standalone onchain transactions) in the response.

Internal transactions are included in the response by passing with-internal and cost 0.05 credits/item.

Example API Call

Recent transactions with internal transactions

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

JSON-RPC

Base is available on the GoldRush JSON-RPC service. Point your existing EVM tooling (ethers.js, viem, web3.js, or raw HTTP) at the GoldRush endpoint — the standard eth_*, net_*, web3_*, debug_*, and trace_* methods are supported.

Endpoint

https://rpc.goldrushdata.com/v1/base-mainnet

Example JSON-RPC Calls

curl https://rpc.goldrushdata.com/v1/base-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

curl https://rpc.goldrushdata.com/v1/base-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"]}'

Sample Methods

See the full method list and per-method examples for Base.

Overview

Popular Chains 🔥

Foundational Chains

Frontier Chains

Community Chains

Archived Chains

Overview

Supported APIs

Foundational API

JSON-RPC

Mainnet

API Usage

Chain Name

Example API Calls

SDK Usage

Foundational API Support

Wallet API

NFT API

Pricing API

Security API

Transactions API

Block Explorer API

Internal Transactions (`with-internal`)

Example API Call

JSON-RPC

Endpoint

Example JSON-RPC Calls

Sample Methods

Additional Resources

​Overview

​Supported APIs

Foundational API

JSON-RPC

​Mainnet

​API Usage

​Chain Name

​Example API Calls

​SDK Usage

​Foundational API Support

​Wallet API

​NFT API

​Pricing API

​Security API

​Transactions API

​Block Explorer API

​Internal Transactions (with-internal)

​Example API Call

​JSON-RPC

​Endpoint

​Example JSON-RPC Calls

​Sample Methods

​Additional Resources

Overview

Supported APIs

Mainnet

API Usage

Chain Name

Example API Calls

SDK Usage

Foundational API Support

Wallet API

NFT API

Pricing API

Security API

Transactions API

Block Explorer API

Internal Transactions (`with-internal`)

Example API Call

JSON-RPC

Endpoint

Example JSON-RPC Calls

Sample Methods

Additional Resources