Bitcoin Chain Intelligence API

Identify any Bitcoin address. Verify transactions. Track whales, exchange flows, and dormant coin moves. Anchor timestamps to the blockchain. Machine-readable JSON with confidence tiers, evidence tiers, and explicit caveats. 14 free endpoints — no signup, no API key.

BTC Price Since 2016

Fee Rate 7d blocks

Hashrate 30d

Coverage

Millions of public labels across the Bitcoin ecosystem — sourced from research datasets, curated anchors, and heuristic clustering. Every label carries its confidence tier, evidence tier, and caveats; most leads are inferred, not verified.

◎Exchanges

⚒Mining

⚠Scams

♦Gambling

★Darknet

⇄Mixers

⚙Services

🏢Government

Capabilities

Three capabilities, one API. Every response includes a confidence tier, an evidence tier, and structured caveats.

Chain Intelligence

Identify any address — entity, category, confidence, evidence tier. Batch up to 100 at once.

Transaction Verification

Confirm payments hit the right address and amount. Look up any txid for inputs, outputs, and fees.

Timestamping

Anchor any hash to the Bitcoin blockchain. Download cryptographic proofs. Verify existing timestamps.

Endpoints

14 free, 16 premium. All return JSON with consistent structure.

FREE No API key required

GET/v1/wallets/{addr}/trust-safety

GET/v1/price

GET/v1/onchain

GET/v1/fees/recommended

GET/v1/mempool/stats

GET/v1/mempool/fee-distribution

GET/v1/chain/whale-alerts

GET/v1/exchange/flows/summary

GET/v1/tx/{txid}/status

POST/v1/feedback

GET/v1/capabilities

GET/v1/timestamp/{hash}

GET/v1/timestamp/quote

POST/v1/timestamp/verify

5–500 sats Paid endpoints · 3 also accept L402/x402

GET/v1/wallets/{addr}/summary

GET/v1/wallets/{addr}/detail

GET/v1/wallets/{addr}/contributors

GET/v1/wallets/{addr}/intelligence

POST/v1/batch/trust-safety

POST/v1/batch/summary

POST/v1/batch/intelligence

GET/v1/tx/{txid}

POST/v1/tx/verify

GET/v1/exchange/flows

GET/v1/miner/flows

GET/v1/chain/whale-alerts/labeled

GET/v1/chain/dormant-alerts

GET/v1/chain/dormant-movements

GET/v1/chain/activity-feed

POST/v1/timestamp

GET/v1/timestamp/{hash}/proof

Quick start

Free: check any address

                curl https://satoshidata.ai/v1/wallets/bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h/trust-safety
                {
  "address": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
  "label": { "category": "exchange", "value": "Binance Cold Wallet" },
  "confidence": "inferred",
  "evidence_tier": "inferred",
  "claim_type": "inference",
  "assessment": {
    "state": "lead",
    "headline": "Likely exchange lead",
    "label": "Exchange \u00b7 Binance Cold Wallet"
  },
  "consensus": { "state": "building", "contributor_count": 12, "has_conflict": false },
  "caveats": ["This is an inference based on current public and heuristic evidence, not an ownership proof."]
}
              

Paid: full wallet summary (21 sats)

                curl -H "X-WR-API-Key: YOUR_KEY" \
  https://satoshidata.ai/v1/wallets/bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h/summary
                {
  "likely_entity": "Binance Cold Wallet",
  "likely_category": "exchange",
  "confidence": "inferred",
  "evidence_tier": "inferred",
  "label_count": 12,
  "unique_contributors": 12,
  "short_explanation": "Multiple public sources identify this address as a Binance cold wallet (inferred).",
  "caveats": ["Inference from public and heuristic evidence, not an ownership proof."]
}
              

Agent API Bridge Pass

4.99USD/mo

Lightning first · BTC on-chain fallback

All 16 premium endpoints
600 calls/hour rate limit
31-day API key

3 endpoints also accept per-call Lightning (L402) or x402 USDC at $0.01 — no key needed.

Built for agents and developers

✓Machine-readable — consistent JSON with confidence and evidence on every response

✓MCP compatible — listed on Smithery, discoverable via agent-card and OpenAPI

✓No account needed — pay per call with Lightning, or get a monthly API key

✓14 free endpoints — trust-safety, price, fees, mempool, on-chain, whale alerts, exchange flow teaser, tx status, timestamps, feedback, capabilities

✓Native L402 — 3 endpoints accept per-call Lightning payments, no key needed

✓x402 USDC on Base — first-wave live on 3 endpoints (wallet summary, wallet detail, tx verify) at $0.01/call · operator-gated rollout

Documentation

Getting started — 3 steps, no signup

Try a free endpoint

No key, no account. Copy this and run it now:

curl -s https://satoshidata.ai/v1/wallets/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa/trust-safety \
  | python3 -m json.tool

See what premium adds

Free gives you a trust score. Premium gives you full balance, transaction history, and funding sources.

curl -s https://satoshidata.ai/v1/wallets/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa/summary
# → 402 Payment Required (see payment options in response)

Pay and get access

Lightning, x402 USDC, or API key bridge. No account needed — pay per call or get a day pass.

curl -s https://satoshidata.ai/v1/billing/catalog | python3 -m json.tool
# See plans → POST /v1/billing/checkout to pay

Reference

Discovery

Examples (GitHub) OpenAPI spec Agent card Billing catalog Capabilities MCP endpoint Health check

Authentication

Free endpoints need no key. Premium endpoints accept X-WR-API-Key header, native Lightning L402, or x402 USDC on Base — no account needed.

curl -H "X-WR-API-Key: YOUR_KEY" \
  https://satoshidata.ai/v1/wallets/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa/summary

Python

import requests

r = requests.get(
  "https://satoshidata.ai/v1/wallets/"
  "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
  "/trust-safety"
)
data = r.json()
print(data["assessment"]["headline"])

MCP Config

{
  "mcpServers": {
    "satoshidata": {
      "url": "https://smithery.ai/servers/satoshidata/chain-intelligence"
    }
  }
}

View on Smithery

Response format

Every response includes a confidence tier, an evidence tier, and structured caveats:

{
  "address": "bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h",
  "likely_entity": "Binance Cold Wallet",
  "likely_category": "exchange",
  "evidence_tier": "inferred",
  "confidence": "inferred",
  "caveats": ["Inference from public and heuristic evidence, not an ownership proof."]
}