{"schema_version":"1.0","name":"satoshidata-agent-api","description":"Bitcoin chain intelligence API for AI agents.","url":"https://satoshidata.ai/mcp/","transport":"streamable-http","server_version":"0.3.0","discovery":{"openapi":"https://satoshidata.ai/openapi.json","agent_card":"https://satoshidata.ai/.well-known/agent-card.json","capabilities":"https://satoshidata.ai/v1/capabilities","billing_catalog":"https://satoshidata.ai/v1/billing/catalog"},"tools":[{"name":"wallet_trust_safety","description":"Free endpoint returning satoshidata.ai's public trust card for a Bitcoin wallet, including historical_flags and the coarse present-state risk_indicator.","endpoint":"/v1/wallets/{address}/trust-safety","method":"GET","free":true},{"name":"bitcoin_price","description":"Free BTC market snapshot for agents.","endpoint":"/v1/price","method":"GET","free":true},{"name":"network_intelligence","description":"Free combined Bitcoin network summary for agents: price, fees, mempool, and chain context.","endpoint":"/v1/network/summary","method":"GET","free":true},{"name":"wallet_summary","description":"Premium satoshidata.ai chain-intelligence summary for a single Bitcoin address.","endpoint":"/v1/wallets/{address}/summary","method":"GET","free":false},{"name":"submit_feedback","description":"Free machine-readable label corrections, missing-label suggestions, data-quality reports, or general feedback.","endpoint":"/v1/feedback","method":"POST","free":true},{"name":"address_risk","description":"Premium address risk-signals endpoint returning factual entity labels and behavioral flags useful for risk assessment. Not legal, AML, KYT, or compliance advice.","endpoint":"/v1/wallets/{address}/risk-signals","method":"GET","free":false},{"name":"wallet_detail","description":"Premium grouped satoshidata.ai label evidence and detail for a single Bitcoin address.","endpoint":"/v1/wallets/{address}/detail","method":"GET","free":false},{"name":"wallet_contributors","description":"Premium source depth and category distribution for a single Bitcoin address.","endpoint":"/v1/wallets/{address}/contributors","method":"GET","free":false},{"name":"wallet_flow_graph","description":"Free render-ready transaction-flow graph for a Bitcoin wallet address.","endpoint":"/v1/wallets/{address}/flow-graph","method":"GET","free":true},{"name":"fees_recommended","description":"Free current recommended Bitcoin fee estimates from satoshidata.ai.","endpoint":"/v1/fees/recommended","method":"GET","free":true},{"name":"mempool_stats","description":"Free current Bitcoin mempool size, fee floor, and congestion summary.","endpoint":"/v1/mempool/stats","method":"GET","free":true},{"name":"mempool_stress","description":"Free current mempool stress index, with Premium components and hourly history available through Wallet+ or the mempool_stress_history x402 capability.","endpoint":"/v1/network/mempool/stress","method":"GET","free":true,"premium_x402_capability":"mempool_stress_history"},{"name":"mempool_tx","description":"Free inspection of a single unconfirmed Bitcoin transaction currently in the mempool.","endpoint":"/v1/mempool/tx/{txid}","method":"GET","free":true},{"name":"onchain_stats","description":"Free current satoshidata.ai on-chain market and network snapshot.","endpoint":"/v1/onchain","method":"GET","free":true},{"name":"block_detail","description":"Free Bitcoin block metadata, coinbase attribution, and transaction sample for a height or block hash.","endpoint":"/v1/blocks/{height_or_hash}","method":"GET","free":true},{"name":"entity_categories","description":"Free available Bitcoin entity rollup categories, counts, and coverage-state distribution.","endpoint":"/v1/entities/categories","method":"GET","free":true},{"name":"entity_list","description":"Free named Bitcoin entity rollups, optionally filtered by category.","endpoint":"/v1/entities/list","method":"GET","free":true},{"name":"entity_lookup","description":"Free detail for one named Bitcoin entity rollup and a bounded member-address sample.","endpoint":"/v1/entities/{entity_name}","method":"GET","free":true},{"name":"entity_recent_activity","description":"Free bounded recent on-chain activity sample for a small named Bitcoin entity.","endpoint":"/v1/entities/{entity_name}/activity","method":"GET","free":true},{"name":"whale_alerts","description":"Free recent large Bitcoin transfers with label-DB flow classification and offset pagination.","endpoint":"/v1/chain/whale-alerts","method":"GET","free":true},{"name":"pulse_whales","description":"Free recent large Bitcoin movements from satoshidata.ai's live on-chain Pulse feed.","endpoint":"/v1/pulse/whales","method":"GET","free":true},{"name":"pulse_dormant","description":"Free recent dormant-coin reactivations from satoshidata.ai's live on-chain Pulse feed.","endpoint":"/v1/pulse/dormant","method":"GET","free":true},{"name":"pulse_consolidations","description":"Free recent consolidation candidates from satoshidata.ai's live on-chain Pulse feed.","endpoint":"/v1/pulse/consolidations","method":"GET","free":true},{"name":"pulse_summary","description":"Free satoshidata.ai on-chain Pulse scanner health and 24-hour event totals.","endpoint":"/v1/pulse/summary","method":"GET","free":true},{"name":"dormancy_flushes","description":"Free CMCS dormancy awakenings classified as exchange-bound sell pressure, consolidation, or rotation.","endpoint":"/v1/chain/dormancy-flushes","method":"GET","free":true},{"name":"chain_awakenings","description":"Premium Track 2 candidate endpoint returning dormant UTXO spend events filtered by bounded since/until window, minimum dormancy, and minimum BTC value.","endpoint":"/v1/chain/awakenings","method":"GET","free":false},{"name":"pool_list","description":"Free satoshidata.ai mining-pool roster with recent block-share windows.","endpoint":"/v1/pools/list","method":"GET","free":true},{"name":"pool_detail","description":"Free satoshidata.ai mining-pool detail for a named pool.","endpoint":"/v1/pools/{pool_name}","method":"GET","free":true},{"name":"tx_status","description":"Free narrow Bitcoin transaction state check: unknown, mempool, conflicted, or confirmed.","endpoint":"/v1/tx/{txid}/status","method":"GET","free":true},{"name":"op_return_decode","description":"Free OP_RETURN protocol-marker and ordinals-inscription envelope decoder for a Bitcoin transaction.","endpoint":"/v1/tx/{txid}/op-return","method":"GET","free":true},{"name":"timestamp_quote","description":"Free timestamp service-fee plus estimated Bitcoin anchor-fee share quote.","endpoint":"/v1/timestamp/quote","method":"GET","free":true},{"name":"timestamp_hash","description":"Paid bridge endpoint accepting a SHA-256 digest for the current proof-of-existence batch.","endpoint":"/v1/timestamp","method":"POST","free":false},{"name":"verify_timestamp","description":"Free endpoint verifying an OpenTimestamps detached proof against the current Bitcoin blockchain view.","endpoint":"/v1/timestamp/verify","method":"POST","free":true},{"name":"tx_broadcast","description":"Broadcast a fully signed raw Bitcoin transaction hex through satoshidata.ai's Bitcoin Core node.","endpoint":"/v1/tx/broadcast","method":"POST","free":true},{"name":"tx_verify","description":"Premium payment-verification endpoint that checks amount, recipient address, and confirmations.","endpoint":"/v1/tx/verify","method":"POST","free":false},{"name":"batch_trust_safety","description":"Look up labels and trust-safety signals for multiple Bitcoin addresses in one call.","endpoint":"/v1/batch/trust-safety","method":"POST","free":false,"deprecated_aliases":[{"name":"wallet-batch-trust-safety","expires":"2026-06-01","reason":"Live pre-P663 agent-card/static MCP name retained for one beta cycle; use canonical batch_trust_safety before 2026-06-01.","canonical_name":"batch_trust_safety","deprecated":true}]},{"name":"batch_summary","description":"Paid batch endpoint returning satoshidata.ai wallet/entity summaries for up to 100 Bitcoin wallets in one call.","endpoint":"/v1/batch/summary","method":"POST","free":false,"deprecated_aliases":[{"name":"wallet-batch-summary","expires":"2026-06-01","reason":"Live pre-P663 agent-card/static MCP name retained for one beta cycle; use canonical batch_summary before 2026-06-01.","canonical_name":"batch_summary","deprecated":true}]},{"name":"batch_risk_signals","description":"Paid labels-only batch risk-signals endpoint. Accepts up to 100 Bitcoin addresses. Batch results intentionally omit live behavioral scans so the surface stays bounded and auditable.","endpoint":"/v1/batch/risk-signals","method":"POST","free":false,"deprecated_aliases":[{"name":"wallet-batch-risk-signals","expires":"2026-06-01","reason":"Live pre-P663 agent-card/static MCP name retained for one beta cycle; use canonical batch_risk_signals before 2026-06-01.","canonical_name":"batch_risk_signals","deprecated":true}]},{"name":"mining_pool_info","description":"Composite MCP-only helper that returns mining-pool attribution by block height/hash, known pool name, or candidate payout address.","endpoint":"mcp://mining_pool_info","method":"GET","free":true,"_meta":{"mcp_only":true}}],"authentication":{"x402":{"status":"prepared_but_closed","live_capabilities":[],"prepared_capabilities":["wallet_summary","mempool_stress_history","chain_awakenings"],"discovery":"https://satoshidata.ai/.well-known/x402","resources":[{"capability":"wallet_summary","description":"Premium wallet/entity summary.","status":"prepared","settlement_enabled":false,"resources":["https://satoshidata.ai/v1/wallets/{address}/summary"],"accepts":[{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","amount":"10000","priceUsd":"0.01","payTo":null,"maxTimeoutSeconds":300}]},{"capability":"mempool_stress_history","description":"Premium mempool-stress component breakdown and rolling hourly history.","status":"prepared","settlement_enabled":false,"resources":["https://satoshidata.ai/v1/network/mempool/stress?include_components=true&history_hours={hours}"],"accepts":[{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","amount":"1000","priceUsd":"0.001","payTo":null,"maxTimeoutSeconds":300}]},{"capability":"chain_awakenings","description":"Dormant-coin awakenings stream - UTXO spend events filtered by min_dormancy_days and min_btc.","status":"prepared","settlement_enabled":false,"resources":["https://satoshidata.ai/v1/chain/awakenings"],"accepts":[{"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","amount":"10000","priceUsd":"0.01","payTo":null,"maxTimeoutSeconds":300}]}]},"wallet_plus":{"subscription_url":"https://satoshis.watch/wallet","bearer_header":"Authorization: Bearer <wallet_plus_session_token>"}},"beta":true}