For agents and integrations
Built MCP-first. Every machine-discoverable surface our API exposes — at the well-known paths agents already look.
MCP most used
/mcp/
Model Context Protocol endpoint. SSE transport. Listed on Smithery.
OpenAPI
/openapi.json
Full machine-readable spec. 59 endpoints, 11 schemas.
Agent Card
/.well-known/agent-card.json
Agent2Agent discovery card. Lists capabilities + auth model.
llms.txt
/llms.txt
Plain-text summary for LLM crawlers. Tiered endpoint list.
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
Public beta: the full API surface is free right now. Billing stays wired for the post-beta access model.
FREE NOW Core surface
GET
/v1/wallets/{addr}/trust-safetyGET
/v1/wallets/{addr}/surveillance-statusGET
/v1/priceGET
/v1/onchainGET
/v1/fees/recommendedGET
/v1/mempool/statsGET
/v1/mempool/fee-distributionGET
/v1/mempool/tx/{txid}GET
/v1/chain/whale-alertsGET
/v1/exchange/flows/summaryGET
/v1/tx/{txid}/statusGET
/v1/tx/{txid}/op-returnPOST
/v1/tx/broadcastPOST
/v1/feedbackGET
/v1/capabilitiesGET
/v1/timestamp/{hash}GET
/v1/timestamp/quotePOST
/v1/timestamp/verifyBETA-FREE Expanded surface · future checkout still preserved
GET
/v1/wallets/{addr}/summaryGET
/v1/wallets/{addr}/detailGET
/v1/wallets/{addr}/contributorsGET
/v1/wallets/{addr}/intelligencePOST
/v1/batch/trust-safetyPOST
/v1/batch/summaryPOST
/v1/batch/intelligenceGET
/v1/tx/{txid}POST
/v1/tx/verifyGET
/v1/exchange/flowsGET
/v1/miner/flowsGET
/v1/chain/whale-alerts/labeledGET
/v1/chain/dormant-alertsGET
/v1/chain/dormant-movementsGET
/v1/chain/activity-feedPOST
/v1/timestampGET
/v1/timestamp/{hash}/proofQuick 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."]
}
Beta-free: full wallet summary (future price 21 sats)
curl \
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."]
}
Public beta
Freefor now
Checkout preserved · Lightning first · BTC on-chain fallback
- Full API surface currently open
- Abuse controls and rate limits stay active
- Post-beta checkout path already preserved
Lightning, x402 USDC on Base, and API-key bridge stay wired for the post-beta model. Public beta itself is free.
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 — public beta is open right now, and the checkout path is preserved for later
✓All endpoints free during beta — trust-safety, wallet depth, batches, exchange flows, miner flows, whale labeling, and timestamps
✓Abuse controls active — generous rate limits plus blocker rules keep the beta usable
✓Future-native settlement preserved — Lightning, x402 USDC, and API-key bridge still exist for the post-beta model