Bitcoin API

Access Bitcoin blockchain data through the Spectrum API. Bitcoin is the original and largest cryptocurrency network. Spectrum provides a focused set of Bitcoin endpoints for block height monitoring, health checks, and raw JSON-RPC passthrough.

Available methods

Bitcoin supports a minimal subset of the Spectrum API. Balance queries, token endpoints, portfolio, ENS, NFTs, contract reads, and DeFi yields are not available for Bitcoin.

Quick start

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \

{
  "jsonrpc": "2.0",
  "method": "getBlockHeight",
  "params": {
    "chain": "bitcoin"
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "chain": "bitcoin",
    "height": 890123
  },
  "id": 1
}

Check Bitcoin node health

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \

{
  "jsonrpc": "2.0",
  "method": "getChainHealth",
  "params": {
    "chain": "bitcoin"
  },
  "id": 1
}

Use Bitcoin JSON-RPC

Send raw Bitcoin Core RPC commands through the Spectrum gateway.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \

{
  "jsonrpc": "2.0",
  "method": "rpcProxy",
  "params": {
    "chain": "bitcoin",
    "method": "getblockchaininfo",
    "params": []
  },
  "id": 1
}

SDK

import { Spectrum } from '@spectrum-nodes/sdk';
const spectrum = new Spectrum({ api: 'https://your-endpoint.simplystaking.xyz/YOUR_API_KEY/' });
 
// Get the latest Bitcoin block height
const block = await spectrum.core.getBlockHeight('bitcoin');
console.log(block.height);
 
// Send a raw Bitcoin RPC call
const info = await spectrum.rpc.call('bitcoin', 'getblockchaininfo', []);
console.log(info);

Endpoint differences from other chains

• Bitcoin uses a UTXO model rather than an account model, so balance and token endpoints are not available through the standard Spectrum API.
• For advanced Bitcoin queries (transaction lookups, UTXO sets, fee estimates), use the JSON-RPC passthrough endpoint to access the full Bitcoin Core RPC interface.

Related pages

• API Reference: Full endpoint documentation
• JSON-RPC: Raw RPC passthrough details
• Supported Chains: All networks