Bitcoin Onchain Data API

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

Overview

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
Official Website	Bitcoin Website
Native Gas Token	BTC

API Usage

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

Chain Name

• btc-mainnet (mainnet)

Example API Calls

Chain Name (Mainnet)

curl -X GET "https://api.covalenthq.com/v1/btc-mainnet/address/34xp4vRoCGJym3xR7yCVPFHoCNxv4Twseo/balances_v2/?key=<GOLDRUSH_API_KEY>"

SDK Usage

TypeScript SDK (Mainnet)

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
• Get Bitcoin balances for HD address

Activity Feed API

• Get transactions for Bitcoin address

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference