> ## 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.

# Base Onchain Data API

> Get token balances and transactions for Base. 28 endpoints supported.

## Overview

<Tip>
  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.
</Tip>

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

<Columns cols={2}>
  <Card title="Foundational API" icon="https://mintcdn.com/goldrush/HCWRKGncxpy71D8p/images/icons/foundational.svg?fit=max&auto=format&n=HCWRKGncxpy71D8p&q=85&s=8a0b97060449218c1b477fe1fffc8a92" href="/docs/goldrush-foundational-api" cta="Read docs" width="24" height="24" data-path="images/icons/foundational.svg">
    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.<br /><br />
    <b>Use cases: Wallets, portfolio trackers, crypto accounting & tax tools, and DeFi dashboards.</b>
  </Card>

  <Card title="JSON-RPC" icon="server" href="/docs/goldrush-json-rpc/overview" cta="Read docs">
    Low-latency EVM JSON-RPC with global failover and archive depth.
    Point your existing tooling at the GoldRush endpoint — no code changes required.<br /><br />
    <b>Use cases: dApps, wallets, indexers, bots, and trading infrastructure.</b>
  </Card>
</Columns>

## Mainnet

| Property             | Value                                  |
| -------------------- | -------------------------------------- |
| **Chain Name**       | `base-mainnet`                         |
| **Chain ID**         | `8453`                                 |
| **Network Type**     | Foundational Chain                     |
| **Support Level**    | foundational                           |
| **Block Explorer**   | [Base Explorer](https://basescan.org/) |
| **Official Website** | [Base Website](https://base.org/)      |
| **Native Gas Token** | ETH                                    |

## API Usage

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

#### Chain Name

* `base-mainnet` (mainnet)

#### Example API Calls

<CodeGroup>
  ```bash Chain Name (Mainnet) theme={null}
  curl -X GET "https://api.covalenthq.com/v1/base-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"
  ```
</CodeGroup>

#### SDK Usage

<CodeGroup>
  ```typescript TypeScript SDK (Mainnet) theme={null}
  import { GoldRushClient } from "@covalenthq/client-sdk";

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

## Foundational API Support

This chain supports **28**  GoldRush Foundational APIs:

#### Wallet API

* **[Get token holders as of any block height (v2) on Base](/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2/)**
* **[Get historical token balances for address on Base](/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address/)**
* **[Get token balances for address on Base](/docs/api-reference/foundational-api/balances/get-token-balances-for-address/)**
* **[Get native token balance for address on Base](/docs/api-reference/foundational-api/balances/get-native-token-balance/)**
* **[Get historical portfolio value over time on Base](/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time/)**
* **[Get ERC20 token transfers for address on Base](/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address/)**

#### NFT API

* **[Get NFTs for address on Base](/docs/api-reference/foundational-api/nft/get-nfts-for-address/)**
* **[Check ownership in NFT collection on Base](/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection/)**
* **[Check ownership in NFT collection for specific token on Base](/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token/)**

#### Pricing API

* **[Get pool spot prices on Base](/docs/api-reference/foundational-api/utility/get-pool-spot-prices/)**
* **[Get historical token prices on Base](/docs/api-reference/foundational-api/utility/get-historical-token-prices/)**

#### Security API

* **[Get token approvals for address on Base](/docs/api-reference/foundational-api/security/get-token-approvals-for-address/)**

#### Transactions API

* **[Get a transaction on Base](/docs/api-reference/foundational-api/transactions/get-a-transaction/)** `with-traces`
* **[Get transaction summary for address on Base](/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address/)**
* **[Get earliest transactions for address (v3)  on Base](/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3/)** `with-traces`
* **[Get recent transactions for address (v3) on Base](/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3/)** `with-traces`
* **[Get paginated transactions for address (v3) on Base](/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3/)** `with-traces`
* **[Get bulk time bucket transactions for address (v3) on Base](/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3/)**
* **[Get all transactions in a block (v3) on Base](/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block/)**
* **[Get all transactions in a block by page (v3)  on Base](/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page/)**

#### Block Explorer API

* **[Get a block on Base](/docs/api-reference/foundational-api/utility/get-a-block/)**
* **[Get all chain statuses on Base](/docs/api-reference/foundational-api/utility/get-all-chain-statuses/)**
* **[Get all chains on Base](/docs/api-reference/foundational-api/utility/get-all-chains/)**
* **[Get block heights on Base](/docs/api-reference/foundational-api/utility/get-block-heights/)**
* **[Get gas prices on Base](/docs/api-reference/foundational-api/utility/get-gas-prices/)**
* **[Get log events by contract address on Base](/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address/)**
* **[Get log events by topic hash(es) on Base](/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash/)**
* **[Get logs on Base](/docs/api-reference/foundational-api/utility/get-logs/)**

## Internal Transactions (`with-internal`)

Base supports **internal transactions** (traces). The Transactions API endpoints marked `with-traces` 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.

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

#### Example API Call

```bash Recent transactions with internal transactions theme={null}
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

<CodeGroup>
  ```bash eth_blockNumber theme={null}
  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":[]}'
  ```

  ```bash eth_getBalance theme={null}
  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"]}'
  ```
</CodeGroup>

#### Sample Methods

* **[eth\_blockNumber on Base](/docs/api-reference/json-rpc/base/eth-blocknumber)**
* **[eth\_getBalance on Base](/docs/api-reference/json-rpc/base/eth-getbalance)**
* **[eth\_call on Base](/docs/api-reference/json-rpc/base/eth-call)**
* **[eth\_getLogs on Base](/docs/api-reference/json-rpc/base/eth-getlogs)**
* **[eth\_getTransactionReceipt on Base](/docs/api-reference/json-rpc/base/eth-gettransactionreceipt)**

See the [full method list and per-method examples for Base](/docs/api-reference/json-rpc/chains/base).

## Additional Resources

* [GoldRush API Documentation](https://goldrush.dev/docs/)
* [Supported Chains List](https://goldrush.dev/chains/)
* [API Reference](https://goldrush.dev/docs/api-reference/)