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 the expanded wallet view

Public beta currently opens the full wallet surface, including summary, detail, and contributor depth.

curl -s https://satoshidata.ai/v1/wallets/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa/summary
# → 200 during public beta

Preview the post-beta path

Lightning, x402 USDC, and the API-key bridge remain wired even while public beta keeps the API free.

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

Reference

Discovery

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

Authentication

Public beta needs no key. The future access model still supports X-WR-API-Key, native Lightning L402, and x402 USDC on Base.

curl 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."]
}