Bitcoin Wallet Intelligence API

Identify any Bitcoin address. Verify transactions. Anchor timestamps to the blockchain. Machine-readable JSON with confidence scoring. 10 free endpoints — no signup, no API key.

BTC Price 1 year —

Fee Rate 24h blocks

Hashrate 7d

Coverage

Millions of labeled addresses across the Bitcoin ecosystem — crowdsourced, scored, and continuously updated.

◎Exchanges209 entities

⚒Mining125 entities

⚠Scams198 entities

♦Gambling227 entities

★Darknet99 entities

⇄Mixers26 entities

⚙Services46 entities

🏢GovernmentSeizures

Capabilities

Three capabilities, one API. Every response includes confidence scoring, evidence tiers, and structured caveats.

Wallet 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

10 free, 9 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/tx/{txid}/status

GET/v1/capabilities

GET/v1/timestamp/{hash}

GET/v1/timestamp/quote

POST/v1/timestamp/verify

21 sats API key, Lightning (L402), or x402 USDC

GET/v1/wallets/{addr}/summary

GET/v1/wallets/{addr}/detail

GET/v1/wallets/{addr}/contributors

POST/v1/batch/trust-safety

POST/v1/batch/summary

GET/v1/tx/{txid}

POST/v1/tx/verify

POST/v1/timestamp

GET/v1/timestamp/{hash}/proof

Quick start

Free: check any address

                curl https://satoshidata.ai/v1/wallets/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa/trust-safety
                {
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "label": { "category": "mining_pool", "value": "Satoshi" },
  "confidence": "high",
  "evidence_tier": "strong",
  "assessment": {
    "state": "labeled",
    "headline": "Likely Satoshi (mining_pool)"
  }
}
              

Paid: full wallet summary (21 sats)

                curl -H "X-WR-API-Key: YOUR_KEY" \
  https://satoshidata.ai/v1/wallets/1BoatSLRHtKNngkdXEeobR76b53LETtpyT/summary
                {
  "likely_entity": "Binance",
  "likely_category": "exchange",
  "confidence": "verified",
  "label_count": 12,
  "unique_contributors": 5,
  "short_explanation": "Verified Binance cold wallet"
}
              

Agent API Bridge Pass

4.99USD/mo

Lightning first · BTC on-chain fallback

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

3 endpoints also accept per-call Lightning (L402) at 21 sats 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

✓10 free endpoints — trust-safety, price, fees, mempool, on-chain, tx status, timestamps, capabilities

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

✓x402 USDC on Base — live on 3 endpoints (wallet summary, wallet detail, tx verify) at $0.01/call

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/wallet-intelligence"
    }
  }
}

View on Smithery

Response format

Every response includes confidence scoring and evidence tiers:

{
  "address": "1BoatSLRHtKNngkdXEeobR76b53LETtpyT",
  "likely_entity": "Binance",
  "likely_category": "exchange",
  "evidence_tier": "strong",
  "confidence": 0.94,
  "caveats": ["multiple_entities"]
}