Bitcoin API Quickstart

Introduction

This quickstart walks you through your first request to the Bitcoin Data API. Under the hood it’s the Moralis Universal API — every endpoint is the same one EVM and Solana developers already use, just with bitcoin as the chain. You’ll fetch BTC balances and a page of wallet history, then call the xpub utility. The interesting part: the wallet endpoints accept either an address or an xpub as input, so you can drop the API into whichever shape your app already has.

Prerequisites

Node.js v18+ installed
A Moralis API key (get one free)

Step 1: Set up your project

mkdir bitcoin-quickstart && cd bitcoin-quickstart
npm init -y

Step 2: Fetch a BTC balance — by address

Create a file called balance-by-address.js:

const API_KEY = 'YOUR_API_KEY';
const ADDRESS = 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq';

async function getBalance() {
  const response = await fetch(
    `https://api.moralis.com/v1/wallets/${ADDRESS}/tokens?chains=bitcoin`,
    { headers: { 'X-API-Key': API_KEY } }
  );

  const data = await response.json();
  console.log(JSON.stringify(data, null, 2));
}

getBalance();

Run it:

node balance-by-address.js

You should see the native BTC balance for the address.

Step 3: Fetch the same kind of balance — by xpub

The same endpoint accepts an xpub. Create balance-by-xpub.js:

const API_KEY = 'YOUR_API_KEY';
const XPUB =
  'xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz';

async function getBalance() {
  const response = await fetch(
    `https://api.moralis.com/v1/wallets/${XPUB}/tokens?chains=bitcoin`,
    { headers: { 'X-API-Key': API_KEY } }
  );

  const data = await response.json();
  console.log(JSON.stringify(data, null, 2));
}

getBalance();

The API derives every address from the xpub and aggregates balances for you. No client-side derivation, no extra libraries.

Step 4: Pull wallet transaction history

const API_KEY = 'YOUR_API_KEY';
const ADDRESS_OR_XPUB = 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq';

async function getHistory() {
  const response = await fetch(
    `https://api.moralis.com/v1/wallets/${ADDRESS_OR_XPUB}/history?chains=bitcoin&limit=10`,
    { headers: { 'X-API-Key': API_KEY } }
  );

  const data = await response.json();
  console.log(JSON.stringify(data, null, 2));
}

getHistory();

Use the returned cursor to paginate.

Step 5: Get the current BTC price (with sparkline)

const API_KEY = 'YOUR_API_KEY';

async function getPrice() {
  const [priceRes, sparkRes] = await Promise.all([
    fetch('https://api.moralis.com/v1/chains/bitcoin/tokens/native/price', {
      headers: { 'X-API-Key': API_KEY },
    }),
    fetch(
      'https://api.moralis.com/v1/chains/bitcoin/tokens/native/price/sparkline',
      { headers: { 'X-API-Key': API_KEY } }
    ),
  ]);

  console.log('price:', await priceRes.json());
  console.log('sparkline:', await sparkRes.json());
}

getPrice();

Step 6: Enumerate the addresses derived from an xpub

If your UI needs to display every address controlled by an xpub (not just query against it), call the utility endpoint:

const API_KEY = 'YOUR_API_KEY';
const XPUB =
  'xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz';

async function getAddresses() {
  const response = await fetch(
    `https://api.moralis.com/v1/chains/bitcoin/wallets/${XPUB}/addresses`,
    { headers: { 'X-API-Key': API_KEY } }
  );

  const data = await response.json();
  console.log(JSON.stringify(data, null, 2));
}

getAddresses();

You’ll get every derived address with its transfer count.

What’s next

Bitcoin Wallet API — balances and history
Bitcoin Price API — current price, history, sparklines
Bitcoin Blockchain API — raw blocks and transactions
Xpub Utility — enumerate derived addresses

Introduction

Getting Started

Pricing & Resources

Tutorials & Guides

Bitcoin API Quickstart

Introduction

Prerequisites

Step 1: Set up your project

Step 2: Fetch a BTC balance — by address

Step 3: Fetch the same kind of balance — by xpub

Step 4: Pull wallet transaction history

Step 5: Get the current BTC price (with sparkline)

Step 6: Enumerate the addresses derived from an xpub

What’s next

Bitcoin API Overview

​Introduction

​Prerequisites

​Step 1: Set up your project

​Step 2: Fetch a BTC balance — by address

​Step 3: Fetch the same kind of balance — by xpub

​Step 4: Pull wallet transaction history

​Step 5: Get the current BTC price (with sparkline)

​Step 6: Enumerate the addresses derived from an xpub

​What’s next

​Bitcoin API Overview

Introduction

Prerequisites

Step 1: Set up your project

Step 2: Fetch a BTC balance — by address

Step 3: Fetch the same kind of balance — by xpub

Step 4: Pull wallet transaction history

Step 5: Get the current BTC price (with sparkline)

Step 6: Enumerate the addresses derived from an xpub

What’s next

Bitcoin API Overview