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

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

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

#### SDK Usage

```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"
});
```

## Foundational API Support

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

#### Wallet API

* **[Get Bitcoin balance for non-HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balance-for-address.md)**
* **[Get Bitcoin balances for HD address](https://goldrush.dev/docs/api-reference/foundational-api/balances/get-bitcoin-balances-for-hd-address.md)**

#### Activity Feed API

* **[Get transactions for Bitcoin address](https://goldrush.dev/docs/api-reference/foundational-api/transactions/get-transactions-for-bitcoin-address.md)**

## Additional Resources

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.