satoshidata.ai — Bitcoin Chain Intelligence API

# SatoshiData.ai > Bitcoin chain-intelligence API for AI agents, developers, and applications. ## Current access state - Product mode: public beta. - Billing mode: beta_free. - Auth mode: beta_public. - During public beta, all documented API endpoints are callable without payment or API key. - During beta, `X-WR-API-Key` is accepted as a forward-compatible no-op. It is shape-checked, acknowledged with `X-WR-API-Key-Mode: beta-noop`, and logged only as a non-secret hash; it does not gate access until post-beta premium enforcement. - Native L402 live capabilities: none right now. - x402 live capabilities: none right now. - x402 prepared capabilities: wallet_summary, mempool_stress_history, chain_awakenings. Always inspect the response `access` block and `_meta` block. They are the source of truth for current auth, freshness, pricing metadata, and docs URL. Every `_meta` block includes `freshness_semantics`: `internal_refresh` means satoshidata.ai refreshed/generated an internal projection, `source_poll` means the timestamp reflects a source scan/poll/cache, and `claim_made` means the timestamp is tied to an observed label/report claim. Every `_meta` block includes `warnings`; treat an empty list as the normal no-warning state. Non-empty warnings are non-fatal caveats such as known Bitcoin test/example addresses. High-frequency GET endpoints may return `ETag` and `Cache-Control`; send `If-None-Match` on repeat polls and handle HTTP `304` as "unchanged". If a response includes old compatibility fields, it will include `Deprecation: true` and `X-WR-Deprecated-Fields`. `Sunset` is intentionally absent until a post-beta removal date is chosen. ## Machine-readable specs - Quickstart: https://satoshidata.ai/quickstart - Changelog: https://satoshidata.ai/changelog - Changelog RSS: https://satoshidata.ai/changelog.rss - OpenAPI: https://satoshidata.ai/openapi.json - Capabilities: https://satoshidata.ai/v1/capabilities - Agent card: https://satoshidata.ai/.well-known/agent-c

{"openapi":"3.1.0","info":{"title":"Satoshidata Agent API","description":"Bitcoin agent API with chain intelligence, Bitcoin timestamping, and machine-readable discovery. Public beta currently makes the full API free while preserving the checkout code path for the post-beta access model. Abuse controls remain active.","version":"0.3.0"},"paths":{"/api/health":{"get":{"tags":["health"],"summary":"Signal API health","description":"Fast liveness response for monitors and AI agents. Use /api/health/