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

# Bitcoin Onchain Data API

> Get token balances and transactions for Bitcoin. 3 endpoints supported.

## Overview

<Tip>
  Bitcoin is the original blockchain and the world's largest cryptocurrency by market cap. GoldRush provides enhanced Bitcoin support including UTXO tracking and historical balances for HD and non-HD addresses.
</Tip>

GoldRush offers the most comprehensive Bitcoin 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 Bitcoin Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

## Mainnet

| Property             | Value                                      |
| -------------------- | ------------------------------------------ |
| **Chain Name**       | `btc-mainnet`                              |
| **Chain ID**         | `20090103`                                 |
| **Network Type**     | Frontier Chain                             |
| **Support Level**    | frontier                                   |
| **Block Explorer**   | [Explorer](https://blockstream.info/)      |
| **Official Website** | [Bitcoin Website](https://bitcoin.org/en/) |
| **Native Gas Token** | BTC                                        |

## API Usage

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

#### Chain Name

* `btc-mainnet` (mainnet)

#### Example API Calls

<CodeGroup>
  ```bash Chain Name (Mainnet) theme={null}
  curl -X GET "https://api.covalenthq.com/v1/btc-mainnet/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo/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: "btc-mainnet",
      walletAddress: "34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo"
  });
  ```
</CodeGroup>

## Foundational API Support

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

#### Wallet API

* **[Get Bitcoin balance for non-HD address](/api-reference/foundational-api/balances/get-bitcoin-balance-for-address)**
* **[Get Bitcoin balances for HD address](/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address)**

#### Activity Feed API

* **[Get transactions for Bitcoin address](/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address)**

## Additional Resources

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