Satoshidata Agent API

{
  "protocolVersion": "1.0",
  "name": "Satoshidata Agent API",
  "description": "Bitcoin intelligence for agents: entity labels, exposure scores, payment verification, timestamping, and label feedback \u2014 confidence and evidence on every answer.",
  "url": "https://satoshidata.ai",
  "provider": {
    "organization": "satoshidata.ai",
    "url": "https://satoshidata.ai"
  },
  "version": "0.3.0",
  "documentationUrl": "https://satoshidata.ai/api/",
  "iconUrl": "https://satoshidata.ai/favicon.svg",
  "supportedInterfaces": [
    {
      "protocolBinding": "https://modelcontextprotocol.io/specification/2025-06-18#streamable-http",
      "protocolVersion": "2025-06-18",
      "url": "https://satoshidata.ai/mcp/v1/"
    },
    {
      "protocolBinding": "https://spec.openapis.org/oas/v3.1",
      "protocolVersion": "3.1.0",
      "url": "https://satoshidata.ai/openapi.json"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://satoshidata.ai/a2a/extensions/http-capability-manifest",
        "description": "Full public HTTP capability names and details are mirrored under x_satoshidata."
      }
    ]
  },
  "securitySchemes": {
    "optionalApiKey": {
      "type": "apiKey",
      "in": "header",
      "name": "X-WR-API-Key",
      "description": "Optional satoshidata.ai API key for post-beta premium access; public beta endpoints remain free."
    }
  },
  "security": [
    {},
    {
      "optionalApiKey": []
    }
  ],
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "wallet_trust_safety",
      "name": "Wallet Trust Safety",
      "description": "Wallet trust and safety teaser",
      "tags": [
        "bitcoin",
        "risk-intelligence",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/trust-safety"
      ]
    },
    {
      "id": "bitcoin_price",
      "name": "Bitcoin Price",
      "description": "Bitcoin price snapshot",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/price"
      ]
    },
    {
      "id": "network_intelligence",
      "name": "Network Intelligence",
      "description": "Network intelligence",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/network/summary"
      ]
    },
    {
      "id": "wallet_summary",
      "name": "Wallet Summary",
      "description": "Wallet summary",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/summary"
      ]
    },
    {
      "id": "submit_feedback",
      "name": "Submit Feedback",
      "description": "Submit feedback",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/feedback"
      ]
    },
    {
      "id": "address_risk",
      "name": "Address Risk",
      "description": "Address risk signals",
      "tags": [
        "bitcoin",
        "risk-intelligence",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/risk-signals"
      ]
    },
    {
      "id": "address_risk_signals",
      "name": "Address Risk Signals",
      "description": "Address risk signals compatibility path",
      "tags": [
        "bitcoin",
        "risk-intelligence",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/address/{address}/risk-signals"
      ]
    },
    {
      "id": "risk_check",
      "name": "Risk Check",
      "description": "Risk check evidence bundle",
      "tags": [
        "bitcoin",
        "risk-intelligence",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/risk-check/{address}"
      ]
    },
    {
      "id": "address_evidence_pack",
      "name": "Address Evidence Pack",
      "description": "Address evidence pack",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/evidence-pack"
      ]
    },
    {
      "id": "wallet_detail",
      "name": "Wallet Detail",
      "description": "Wallet label detail",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/detail"
      ]
    },
    {
      "id": "wallet_contributors",
      "name": "Wallet Contributors",
      "description": "Wallet source depth",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/contributors"
      ]
    },
    {
      "id": "wallet_flow_graph",
      "name": "Wallet Flow Graph",
      "description": "Wallet flow graph",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/flow-graph"
      ]
    },
    {
      "id": "wallet_surveillance_status",
      "name": "Wallet Surveillance Status",
      "description": "Wallet surveillance dust-ping status",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/surveillance-status"
      ]
    },
    {
      "id": "address_intelligence",
      "name": "Address Intelligence",
      "description": "Address intelligence",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/intelligence"
      ]
    },
    {
      "id": "fees_recommended",
      "name": "Fees Recommended",
      "description": "Recommended Bitcoin fee rates",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/fees/recommended"
      ]
    },
    {
      "id": "mempool_stats",
      "name": "Mempool Stats",
      "description": "Bitcoin mempool stats",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/mempool/stats"
      ]
    },
    {
      "id": "mempool_stress",
      "name": "Mempool Stress",
      "description": "Bitcoin mempool stress index",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/network/mempool/stress"
      ]
    },
    {
      "id": "mempool_fee_distribution",
      "name": "Mempool Fee Distribution",
      "description": "Bitcoin mempool fee distribution",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/mempool/fee-distribution"
      ]
    },
    {
      "id": "mempool_tx",
      "name": "Mempool Tx",
      "description": "Inspect an unconfirmed Bitcoin transaction",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/mempool/tx/{txid}"
      ]
    },
    {
      "id": "onchain_stats",
      "name": "Onchain Stats",
      "description": "Live on-chain intelligence snapshot",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/onchain"
      ]
    },
    {
      "id": "block_detail",
      "name": "Block Detail",
      "description": "Bitcoin block detail",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/blocks/{height_or_hash}"
      ]
    },
    {
      "id": "recent_blocks",
      "name": "Recent Blocks",
      "description": "Recent Bitcoin blocks",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/recent-blocks"
      ]
    },
    {
      "id": "projected_blocks",
      "name": "Projected Blocks",
      "description": "Projected Bitcoin mempool blocks",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/projected-blocks"
      ]
    },
    {
      "id": "entity_categories",
      "name": "Entity Categories",
      "description": "Bitcoin entity rollup categories",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/entities/categories"
      ]
    },
    {
      "id": "entity_list",
      "name": "Entity List",
      "description": "Bitcoin entity rollup list",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/entities/list"
      ]
    },
    {
      "id": "entity_directory",
      "name": "Entity Directory",
      "description": "Bitcoin Entity Directory \u2014 labeled entities, category-first.",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/entities/directory"
      ]
    },
    {
      "id": "entity_lookup",
      "name": "Entity Lookup",
      "description": "Bitcoin entity rollup detail",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/entities/{entity_name}"
      ]
    },
    {
      "id": "entity_recent_activity",
      "name": "Entity Recent Activity",
      "description": "Bitcoin entity recent activity",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/entities/{entity_name}/activity"
      ]
    },
    {
      "id": "whale_alerts",
      "name": "Whale Alerts",
      "description": "Bitcoin whale alerts",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/whale-alerts"
      ]
    },
    {
      "id": "whale_alerts_labeled",
      "name": "Whale Alerts Labeled",
      "description": "Labeled Bitcoin whale alerts",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/whale-alerts/labeled"
      ]
    },
    {
      "id": "pulse_whales",
      "name": "Pulse Whales",
      "description": "On-chain Pulse whale movements",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/pulse/whales"
      ]
    },
    {
      "id": "pulse_dormant",
      "name": "Pulse Dormant",
      "description": "On-chain Pulse dormant reactivations",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/pulse/dormant"
      ]
    },
    {
      "id": "pulse_consolidations",
      "name": "Pulse Consolidations",
      "description": "On-chain Pulse consolidations",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/pulse/consolidations"
      ]
    },
    {
      "id": "pulse_summary",
      "name": "Pulse Summary",
      "description": "On-chain Pulse summary",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/pulse/summary"
      ]
    },
    {
      "id": "dormancy_flushes",
      "name": "Dormancy Flushes",
      "description": "Bitcoin dormancy flushes",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/dormancy-flushes"
      ]
    },
    {
      "id": "exchange_flows_summary",
      "name": "Exchange Flows Summary",
      "description": "Bitcoin exchange flow summary",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/exchange/flows/summary"
      ]
    },
    {
      "id": "exchange_flows",
      "name": "Exchange Flows",
      "description": "Bitcoin exchange flows",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/exchange/flows"
      ]
    },
    {
      "id": "miner_flows",
      "name": "Miner Flows",
      "description": "Bitcoin miner flows",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/miner/flows"
      ]
    },
    {
      "id": "dormancy_whale_wakeups",
      "name": "Dormancy Whale Wakeups",
      "description": "Dormancy Watch whale wakeups",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/dormancy/whale-wakeups"
      ]
    },
    {
      "id": "dormancy_watchlist",
      "name": "Dormancy Watchlist",
      "description": "Dormancy Watch observatory watchlist",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/dormancy/watchlist"
      ]
    },
    {
      "id": "dormancy_weekly",
      "name": "Dormancy Weekly",
      "description": "Dormancy Watch weekly rollup",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/dormancy/weekly.json"
      ]
    },
    {
      "id": "dormant_movements",
      "name": "Dormant Movements",
      "description": "Bitcoin dormant coin movements",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/dormant-movements"
      ]
    },
    {
      "id": "chain_awakenings",
      "name": "Chain Awakenings",
      "description": "Bitcoin dormant coin awakenings",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/awakenings"
      ]
    },
    {
      "id": "activity_feed",
      "name": "Activity Feed",
      "description": "Bitcoin chain activity feed",
      "tags": [
        "bitcoin",
        "network-data"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/activity-feed"
      ]
    },
    {
      "id": "supply_distribution",
      "name": "Supply Distribution",
      "description": "BTC supply distribution",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/chain/supply-distribution"
      ]
    },
    {
      "id": "pool_list",
      "name": "Pool List",
      "description": "Bitcoin mining pool list",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/pools/list"
      ]
    },
    {
      "id": "pool_detail",
      "name": "Pool Detail",
      "description": "Bitcoin mining pool detail",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/pools/{pool_name}"
      ]
    },
    {
      "id": "tx_status",
      "name": "Tx Status",
      "description": "Get Bitcoin transaction status",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/tx/{txid}/status"
      ]
    },
    {
      "id": "tx_lookup",
      "name": "Tx Lookup",
      "description": "Lookup a Bitcoin transaction",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/tx/{txid}"
      ]
    },
    {
      "id": "op_return_decode",
      "name": "Op Return Decode",
      "description": "Decode Bitcoin OP_RETURN markers",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/tx/{txid}/op-return"
      ]
    },
    {
      "id": "timestamp_quote",
      "name": "Timestamp Quote",
      "description": "Get timestamp preflight quote",
      "tags": [
        "bitcoin",
        "timestamping"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/timestamp/quote"
      ]
    },
    {
      "id": "timestamp_hash",
      "name": "Timestamp Hash",
      "description": "Submit a SHA-256 hash for Bitcoin anchoring",
      "tags": [
        "bitcoin",
        "timestamping"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/timestamp"
      ]
    },
    {
      "id": "timestamp_status",
      "name": "Timestamp Status",
      "description": "Check timestamp status",
      "tags": [
        "bitcoin",
        "timestamping"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/timestamp/{hash_hex}"
      ]
    },
    {
      "id": "timestamp_proof",
      "name": "Timestamp Proof",
      "description": "Download the detached OpenTimestamps proof",
      "tags": [
        "bitcoin",
        "timestamping"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/timestamp/{hash_hex}/proof"
      ]
    },
    {
      "id": "verify_timestamp",
      "name": "Verify Timestamp",
      "description": "Verify a detached proof against Bitcoin",
      "tags": [
        "bitcoin",
        "timestamping"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/timestamp/verify"
      ]
    },
    {
      "id": "tx_broadcast",
      "name": "Tx Broadcast",
      "description": "Broadcast a signed Bitcoin transaction",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/tx/broadcast"
      ]
    },
    {
      "id": "tx_verify",
      "name": "Tx Verify",
      "description": "Verify a Bitcoin payment landed",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/tx/verify"
      ]
    },
    {
      "id": "batch_trust_safety",
      "name": "Batch Trust Safety",
      "description": "Batch wallet trust and safety",
      "tags": [
        "bitcoin",
        "risk-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/batch/trust-safety"
      ]
    },
    {
      "id": "batch_summary",
      "name": "Batch Summary",
      "description": "Batch chain intelligence summary",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/batch/summary"
      ]
    },
    {
      "id": "batch_intelligence",
      "name": "Batch Intelligence",
      "description": "Batch address intelligence",
      "tags": [
        "bitcoin"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/batch/intelligence"
      ]
    },
    {
      "id": "batch_risk_signals",
      "name": "Batch Risk Signals",
      "description": "Batch address risk signals",
      "tags": [
        "bitcoin",
        "risk-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/batch/risk-signals"
      ]
    },
    {
      "id": "risk_check_batch",
      "name": "Risk Check Batch",
      "description": "Batch risk check evidence bundles",
      "tags": [
        "bitcoin",
        "risk-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "POST /v1/risk-check/batch"
      ]
    },
    {
      "id": "wallet_pnl",
      "name": "Wallet Pnl",
      "description": "Average-cost wallet P&L rollup",
      "tags": [
        "bitcoin",
        "wallet-intelligence"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        "GET /v1/wallets/{address}/pnl"
      ]
    }
  ],
  "x_satoshidata": {
    "legacy_capabilities": [
      "wallet_trust_safety",
      "bitcoin_price",
      "network_intelligence",
      "wallet_summary",
      "submit_feedback",
      "address_risk",
      "address_risk_signals",
      "risk_check",
      "address_evidence_pack",
      "wallet_detail",
      "wallet_contributors",
      "wallet_flow_graph",
      "wallet_surveillance_status",
      "address_intelligence",
      "fees_recommended",
      "mempool_stats",
      "mempool_stress",
      "mempool_fee_distribution",
      "mempool_tx",
      "onchain_stats",
      "block_detail",
      "recent_blocks",
      "projected_blocks",
      "entity_categories",
      "entity_list",
      "entity_directory",
      "entity_lookup",
      "entity_recent_activity",
      "whale_alerts",
      "whale_alerts_labeled",
      "pulse_whales",
      "pulse_dormant",
      "pulse_consolidations",
      "pulse_summary",
      "dormancy_flushes",
      "exchange_flows_summary",
      "exchange_flows",
      "miner_flows",
      "dormancy_whale_wakeups",
      "dormancy_watchlist",
      "dormancy_weekly",
      "dormant_movements",
      "chain_awakenings",
      "activity_feed",
      "supply_distribution",
      "pool_list",
      "pool_detail",
      "tx_status",
      "tx_lookup",
      "op_return_decode",
      "timestamp_quote",
      "timestamp_hash",
      "timestamp_status",
      "timestamp_proof",
      "verify_timestamp",
      "tx_broadcast",
      "tx_verify",
      "batch_trust_safety",
      "batch_summary",
      "batch_intelligence",
      "batch_risk_signals",
      "risk_check_batch",
      "wallet_pnl"
    ],
    "capability_details": [
      {
        "name": "wallet_trust_safety",
        "endpoint": "/v1/wallets/{address}/trust-safety",
        "method": "GET",
        "access_tier": "free",
        "summary": "Wallet trust and safety teaser",
        "pricing_capability": "wallet_trust_safety"
      },
      {
        "name": "bitcoin_price",
        "endpoint": "/v1/price",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin price snapshot",
        "pricing_capability": "price_snapshot"
      },
      {
        "name": "network_intelligence",
        "endpoint": "/v1/network/summary",
        "method": "GET",
        "access_tier": "free",
        "summary": "Network intelligence",
        "pricing_capability": "network_summary"
      },
      {
        "name": "wallet_summary",
        "endpoint": "/v1/wallets/{address}/summary",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Wallet summary",
        "pricing_capability": "wallet_summary"
      },
      {
        "name": "submit_feedback",
        "endpoint": "/v1/feedback",
        "method": "POST",
        "access_tier": "free",
        "summary": "Submit feedback",
        "pricing_capability": "feedback_submit"
      },
      {
        "name": "address_risk",
        "endpoint": "/v1/wallets/{address}/risk-signals",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Address risk signals",
        "pricing_capability": "address_risk_signals"
      },
      {
        "name": "address_risk_signals",
        "endpoint": "/v1/address/{address}/risk-signals",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Address risk signals compatibility path",
        "pricing_capability": "address_risk_signals"
      },
      {
        "name": "risk_check",
        "endpoint": "/v1/risk-check/{address}",
        "method": "GET",
        "access_tier": "free",
        "summary": "Risk check evidence bundle",
        "pricing_capability": "risk_check"
      },
      {
        "name": "address_evidence_pack",
        "endpoint": "/v1/wallets/{address}/evidence-pack",
        "method": "GET",
        "access_tier": "free",
        "summary": "Address evidence pack",
        "pricing_capability": "address_evidence_pack"
      },
      {
        "name": "wallet_detail",
        "endpoint": "/v1/wallets/{address}/detail",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Wallet label detail",
        "pricing_capability": "wallet_detail"
      },
      {
        "name": "wallet_contributors",
        "endpoint": "/v1/wallets/{address}/contributors",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Wallet source depth",
        "pricing_capability": "wallet_contributors"
      },
      {
        "name": "wallet_flow_graph",
        "endpoint": "/v1/wallets/{address}/flow-graph",
        "method": "GET",
        "access_tier": "free",
        "summary": "Wallet flow graph",
        "pricing_capability": "wallet_flow_graph"
      },
      {
        "name": "wallet_surveillance_status",
        "endpoint": "/v1/wallets/{address}/surveillance-status",
        "method": "GET",
        "access_tier": "free",
        "summary": "Wallet surveillance dust-ping status",
        "pricing_capability": "wallet_surveillance_status"
      },
      {
        "name": "address_intelligence",
        "endpoint": "/v1/wallets/{address}/intelligence",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Address intelligence",
        "pricing_capability": "address_intelligence"
      },
      {
        "name": "fees_recommended",
        "endpoint": "/v1/fees/recommended",
        "method": "GET",
        "access_tier": "free",
        "summary": "Recommended Bitcoin fee rates",
        "pricing_capability": "fees_recommended"
      },
      {
        "name": "mempool_stats",
        "endpoint": "/v1/mempool/stats",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin mempool stats",
        "pricing_capability": "mempool_stats"
      },
      {
        "name": "mempool_stress",
        "endpoint": "/v1/network/mempool/stress",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin mempool stress index",
        "pricing_capability": "mempool_stress",
        "premium_x402_capability": "mempool_stress_history"
      },
      {
        "name": "mempool_fee_distribution",
        "endpoint": "/v1/mempool/fee-distribution",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin mempool fee distribution",
        "pricing_capability": "mempool_fee_distribution"
      },
      {
        "name": "mempool_tx",
        "endpoint": "/v1/mempool/tx/{txid}",
        "method": "GET",
        "access_tier": "free",
        "summary": "Inspect an unconfirmed Bitcoin transaction",
        "pricing_capability": "mempool_tx"
      },
      {
        "name": "onchain_stats",
        "endpoint": "/v1/onchain",
        "method": "GET",
        "access_tier": "free",
        "summary": "Live on-chain intelligence snapshot",
        "pricing_capability": "onchain_snapshot"
      },
      {
        "name": "block_detail",
        "endpoint": "/v1/blocks/{height_or_hash}",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin block detail",
        "pricing_capability": "block_detail"
      },
      {
        "name": "recent_blocks",
        "endpoint": "/v1/chain/recent-blocks",
        "method": "GET",
        "access_tier": "free",
        "summary": "Recent Bitcoin blocks",
        "pricing_capability": "recent_blocks"
      },
      {
        "name": "projected_blocks",
        "endpoint": "/v1/chain/projected-blocks",
        "method": "GET",
        "access_tier": "free",
        "summary": "Projected Bitcoin mempool blocks",
        "pricing_capability": "projected_blocks"
      },
      {
        "name": "entity_categories",
        "endpoint": "/v1/entities/categories",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin entity rollup categories",
        "pricing_capability": "entity_categories"
      },
      {
        "name": "entity_list",
        "endpoint": "/v1/entities/list",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin entity rollup list",
        "pricing_capability": "entity_list"
      },
      {
        "name": "entity_directory",
        "endpoint": "/v1/entities/directory",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin Entity Directory \u2014 labeled entities, category-first.",
        "pricing_capability": "entity_directory"
      },
      {
        "name": "entity_lookup",
        "endpoint": "/v1/entities/{entity_name}",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin entity rollup detail",
        "pricing_capability": "entity_lookup"
      },
      {
        "name": "entity_recent_activity",
        "endpoint": "/v1/entities/{entity_name}/activity",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin entity recent activity",
        "pricing_capability": "entity_recent_activity"
      },
      {
        "name": "whale_alerts",
        "endpoint": "/v1/chain/whale-alerts",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin whale alerts",
        "pricing_capability": "whale_alerts"
      },
      {
        "name": "whale_alerts_labeled",
        "endpoint": "/v1/chain/whale-alerts/labeled",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Labeled Bitcoin whale alerts",
        "pricing_capability": "whale_alerts_labeled"
      },
      {
        "name": "pulse_whales",
        "endpoint": "/v1/pulse/whales",
        "method": "GET",
        "access_tier": "free",
        "summary": "On-chain Pulse whale movements",
        "pricing_capability": "pulse_whales"
      },
      {
        "name": "pulse_dormant",
        "endpoint": "/v1/pulse/dormant",
        "method": "GET",
        "access_tier": "free",
        "summary": "On-chain Pulse dormant reactivations",
        "pricing_capability": "pulse_dormant"
      },
      {
        "name": "pulse_consolidations",
        "endpoint": "/v1/pulse/consolidations",
        "method": "GET",
        "access_tier": "free",
        "summary": "On-chain Pulse consolidations",
        "pricing_capability": "pulse_consolidations"
      },
      {
        "name": "pulse_summary",
        "endpoint": "/v1/pulse/summary",
        "method": "GET",
        "access_tier": "free",
        "summary": "On-chain Pulse summary",
        "pricing_capability": "pulse_summary"
      },
      {
        "name": "dormancy_flushes",
        "endpoint": "/v1/chain/dormancy-flushes",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin dormancy flushes",
        "pricing_capability": "dormancy_flushes"
      },
      {
        "name": "exchange_flows_summary",
        "endpoint": "/v1/exchange/flows/summary",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin exchange flow summary",
        "pricing_capability": "exchange_flows_summary"
      },
      {
        "name": "exchange_flows",
        "endpoint": "/v1/exchange/flows",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Bitcoin exchange flows",
        "pricing_capability": "exchange_flows"
      },
      {
        "name": "miner_flows",
        "endpoint": "/v1/miner/flows",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Bitcoin miner flows",
        "pricing_capability": "miner_flows"
      },
      {
        "name": "dormancy_whale_wakeups",
        "endpoint": "/v1/dormancy/whale-wakeups",
        "method": "GET",
        "access_tier": "free",
        "summary": "Dormancy Watch whale wakeups",
        "pricing_capability": "dormancy_whale_wakeups"
      },
      {
        "name": "dormancy_watchlist",
        "endpoint": "/v1/dormancy/watchlist",
        "method": "GET",
        "access_tier": "free",
        "summary": "Dormancy Watch observatory watchlist",
        "pricing_capability": "dormancy_watchlist"
      },
      {
        "name": "dormancy_weekly",
        "endpoint": "/v1/dormancy/weekly.json",
        "method": "GET",
        "access_tier": "free",
        "summary": "Dormancy Watch weekly rollup",
        "pricing_capability": "dormancy_weekly"
      },
      {
        "name": "dormant_movements",
        "endpoint": "/v1/chain/dormant-movements",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Bitcoin dormant coin movements",
        "pricing_capability": "dormant_movements"
      },
      {
        "name": "chain_awakenings",
        "endpoint": "/v1/chain/awakenings",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Bitcoin dormant coin awakenings",
        "pricing_capability": "chain_awakenings"
      },
      {
        "name": "activity_feed",
        "endpoint": "/v1/chain/activity-feed",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Bitcoin chain activity feed",
        "pricing_capability": "activity_feed"
      },
      {
        "name": "supply_distribution",
        "endpoint": "/v1/chain/supply-distribution",
        "method": "GET",
        "access_tier": "premium",
        "summary": "BTC supply distribution",
        "pricing_capability": "supply_distribution"
      },
      {
        "name": "pool_list",
        "endpoint": "/v1/pools/list",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin mining pool list",
        "pricing_capability": "pool_list"
      },
      {
        "name": "pool_detail",
        "endpoint": "/v1/pools/{pool_name}",
        "method": "GET",
        "access_tier": "free",
        "summary": "Bitcoin mining pool detail",
        "pricing_capability": "pool_detail"
      },
      {
        "name": "tx_status",
        "endpoint": "/v1/tx/{txid}/status",
        "method": "GET",
        "access_tier": "free",
        "summary": "Get Bitcoin transaction status",
        "pricing_capability": "tx_status"
      },
      {
        "name": "tx_lookup",
        "endpoint": "/v1/tx/{txid}",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Lookup a Bitcoin transaction",
        "pricing_capability": "tx_lookup"
      },
      {
        "name": "op_return_decode",
        "endpoint": "/v1/tx/{txid}/op-return",
        "method": "GET",
        "access_tier": "free",
        "summary": "Decode Bitcoin OP_RETURN markers",
        "pricing_capability": "op_return_decode"
      },
      {
        "name": "timestamp_quote",
        "endpoint": "/v1/timestamp/quote",
        "method": "GET",
        "access_tier": "free",
        "summary": "Get timestamp preflight quote",
        "pricing_capability": "timestamp_quote"
      },
      {
        "name": "timestamp_hash",
        "endpoint": "/v1/timestamp",
        "method": "POST",
        "access_tier": "premium",
        "summary": "Submit a SHA-256 hash for Bitcoin anchoring",
        "pricing_capability": "timestamp_submit"
      },
      {
        "name": "timestamp_status",
        "endpoint": "/v1/timestamp/{hash_hex}",
        "method": "GET",
        "access_tier": "free",
        "summary": "Check timestamp status",
        "pricing_capability": "timestamp_status"
      },
      {
        "name": "timestamp_proof",
        "endpoint": "/v1/timestamp/{hash_hex}/proof",
        "method": "GET",
        "access_tier": "premium",
        "summary": "Download the detached OpenTimestamps proof",
        "pricing_capability": "timestamp_proof_download"
      },
      {
        "name": "verify_timestamp",
        "endpoint": "/v1/timestamp/verify",
        "method": "POST",
        "access_tier": "free",
        "summary": "Verify a detached proof against Bitcoin",
        "pricing_capability": "timestamp_verify"
      },
      {
        "name": "tx_broadcast",
        "endpoint": "/v1/tx/broadcast",
        "method": "POST",
        "access_tier": "free",
        "summary": "Broadcast a signed Bitcoin transaction",
        "pricing_capability": "tx_broadcast"
      },
      {
        "name": "tx_verify",
        "endpoint": "/v1/tx/verify",
        "method": "POST",
        "access_tier": "premium",
        "summary": "Verify a Bitcoin payment landed",
        "pricing_capability": "tx_verify"
      },
      {
        "name": "batch_trust_safety",
        "endpoint": "/v1/batch/trust-safety",
        "method": "POST",
        "access_tier": "premium",
        "summary": "Batch wallet trust and safety",
        "pricing_capability": "batch_trust_safety"
      },
      {
        "name": "batch_summary",
        "endpoint": "/v1/batch/summary",
        "method": "POST",
        "access_tier": "premium",
        "summary": "Batch chain intelligence summary",
        "pricing_capability": "batch_summary"
      },
      {
        "name": "batch_intelligence",
        "endpoint": "/v1/batch/intelligence",
        "method": "POST",
        "access_tier": "premium",
        "summary": "Batch address intelligence",
        "pricing_capability": "batch_intelligence"
      },
      {
        "name": "batch_risk_signals",
        "endpoint": "/v1/batch/risk-signals",
        "method": "POST",
        "access_tier": "premium",
        "summary": "Batch address risk signals",
        "pricing_capability": "batch_risk_signals"
      },
      {
        "name": "risk_check_batch",
        "endpoint": "/v1/risk-check/batch",
        "method": "POST",
        "access_tier": "free",
        "summary": "Batch risk check evidence bundles",
        "pricing_capability": "risk_check_batch"
      },
      {
        "name": "wallet_pnl",
        "endpoint": "/v1/wallets/{address}/pnl",
        "method": "GET",
        "access_tier": "free",
        "summary": "Average-cost wallet P&L rollup",
        "pricing_capability": "wallet_pnl"
      }
    ],
    "discovery_authority": {
      "full_api_surface": "agent-card.capabilities lists the full public HTTP API capability surface.",
      "mcp_subset": ".well-known/mcp.json tools are the MCP-exposed subset, plus explicit mcp_only tools.",
      "live_access_state": "/v1/capabilities is the current access, billing, beta, and x402 state.",
      "canonical_schema": "/openapi.json is the canonical request and response schema."
    }
  },
  "openapi": "https://satoshidata.ai/openapi.json",
  "links": {
    "capabilities": "https://satoshidata.ai/v1/capabilities",
    "billing_catalog": "https://satoshidata.ai/v1/billing/catalog",
    "mcp": "https://satoshidata.ai/mcp/v1/",
    "x402": "https://satoshidata.ai/.well-known/x402"
  },
  "discovery_authority": {
    "full_api_surface": "agent-card.capabilities lists the full public HTTP API capability surface.",
    "mcp_subset": ".well-known/mcp.json tools are the MCP-exposed subset, plus explicit mcp_only tools.",
    "live_access_state": "/v1/capabilities is the current access, billing, beta, and x402 state.",
    "canonical_schema": "/openapi.json is the canonical request and response schema."
  },
  "deprecated_aliases": {},
  "mcp_only_tools_policy": {
    "marker": "_meta.mcp_only",
    "tools": [
      "mining_pool_info"
    ],
    "note": "MCP tool entries marked _meta.mcp_only=true are callable only through MCP and are intentionally omitted from agent-card HTTP capabilities."
  },
  "beta": true,
  "auth": {
    "type": "none",
    "header": "X-WR-API-Key",
    "current_header": "none",
    "scheme": "api_key_bridge",
    "plan_id": "wallet-monthly",
    "required": false,
    "access": "beta_free",
    "obtain": "https://satoshidata.ai/v1/billing/checkout",
    "catalog": "https://satoshidata.ai/v1/billing/catalog",
    "native_first_wave_capabilities": [
      "wallet_summary",
      "wallet_detail",
      "tx_verify"
    ],
    "x402_first_wave_capabilities": [],
    "prepared_x402_capabilities": [
      "wallet_summary",
      "mempool_stress_history",
      "chain_awakenings"
    ]
  },
  "pricing": {
    "live_access_model": "beta_free",
    "target_access_model": "402_per_call",
    "billing_paused": true,
    "bridge_plan_id": "wallet-monthly",
    "endpoint_pricing": [
      {
        "capability": "wallet_trust_safety",
        "access_tier": "free",
        "endpoints": [
          "/v1/wallets/{address}/trust-safety"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free trust & safety first look at an address \u2014 states plainly whether we examined it and whether anything matched.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "wallet_surveillance_status",
        "access_tier": "free",
        "endpoints": [
          "/v1/wallets/{address}/surveillance-status"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free wallet surveillance dust-ping status.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "wallet_flow_graph",
        "access_tier": "free",
        "endpoints": [
          "/v1/wallets/{address}/flow-graph"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free wallet transaction-flow graph.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "wallet_pnl",
        "access_tier": "free",
        "endpoints": [
          "/v1/wallets/{address}/pnl"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Average-cost wallet P&L: free for bounded small histories and the public showcase, then Wallet+.",
        "target_access_model": "conditional_wallet_plus",
        "live_access_model": "conditional_free_then_wallet_plus",
        "conditional_access": {
          "basis": "wallet_transaction_count",
          "free_max_transactions": 100,
          "public_showcase_addresses": [
            "12cbQLTFMXRnSzktFkuoG3eHoMeFtpTu3S",
            "3LYJfcfHPXYJreMsASk2jkn69LWEYKzexb",
            "bc1qgdjqv0av3q56jvd82tkdjpy7gdp9ut8tlqmgrpmv24sq90ecnvqqjwvw97"
          ],
          "upgrade_access": "wallet_plus",
          "hard_max_transactions": 1000,
          "over_hard_limit_status": 503
        },
        "current_access_tier": "conditional_free_then_wallet_plus",
        "currently_billable": false
      },
      {
        "capability": "address_evidence_pack",
        "access_tier": "free",
        "endpoints": [
          "/v1/wallets/{address}/evidence-pack"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free sectioned address evidence report with component statuses and no verdict.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "feedback_submit",
        "access_tier": "free",
        "endpoints": [
          "POST /v1/feedback"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free machine-readable label, data-quality, and general product feedback.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "price_snapshot",
        "access_tier": "free",
        "endpoints": [
          "/v1/price"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free BTC market snapshot without stale technical-analysis indicators.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "onchain_snapshot",
        "access_tier": "free",
        "endpoints": [
          "/v1/onchain"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "On-chain network snapshot from our own node, plus satoshidata's derived metrics and scores.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "fees_recommended",
        "access_tier": "free",
        "endpoints": [
          "/v1/fees/recommended"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free fee-rate recommendations.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "mempool_stats",
        "access_tier": "free",
        "endpoints": [
          "/v1/mempool/stats"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free Bitcoin mempool state snapshot.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "mempool_fee_distribution",
        "access_tier": "free",
        "endpoints": [
          "/v1/mempool/fee-distribution"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free Bitcoin mempool fee-rate histogram.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "mempool_tx",
        "access_tier": "free",
        "endpoints": [
          "/v1/mempool/tx/{txid}"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free unconfirmed Bitcoin transaction mempool inspection.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "mempool_stress",
        "access_tier": "free",
        "endpoints": [
          "/v1/network/mempool/stress"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free current mempool-stress composite index for agent trading loops.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "block_detail",
        "access_tier": "free",
        "endpoints": [
          "/v1/blocks/{height_or_hash}"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free Bitcoin block metadata, coinbase attribution, and bounded transaction sample.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "recent_blocks",
        "access_tier": "free",
        "endpoints": [
          "/v1/chain/recent-blocks"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free compact recent mined blocks for satoshis.watch live block progression.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "projected_blocks",
        "access_tier": "free",
        "endpoints": [
          "/v1/chain/projected-blocks"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free compact projected mempool blocks for satoshis.watch live block progression.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "entity_list",
        "access_tier": "free",
        "endpoints": [
          "/v1/entities/list"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free list of labeled Bitcoin entities \u2014 category, address count, optional balance, coverage, confidence, and last-activity date per entity.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "entity_directory",
        "access_tier": "free",
        "endpoints": [
          "/v1/entities/directory"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free, category-first directory of labeled Bitcoin entities \u2014 directory-grade counts, sensitive categories shown only with sufficient evidence-tier support, and compact entity cards.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "entity_lookup",
        "access_tier": "free",
        "endpoints": [
          "/v1/entities/{entity_name}"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free entity detail \u2014 a bounded sample of member addresses, a coverage caveat, confidence, and last-activity date.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "entity_recent_activity",
        "access_tier": "free",
        "endpoints": [
          "/v1/entities/{entity_name}/activity"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free recent on-chain activity sample for small labeled entities.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "entity_categories",
        "access_tier": "free",
        "endpoints": [
          "/v1/entities/categories"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free entity counts by category, with a coverage breakdown.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "network_summary",
        "access_tier": "free",
        "endpoints": [
          "/v1/network/summary"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free combined Bitcoin network summary with hashrate methodology fields.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "whale_alerts",
        "access_tier": "free",
        "endpoints": [
          "/v1/chain/whale-alerts"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free recent large Bitcoin transfer alerts with label-DB flow_type and flow_direction classification.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "pulse_whales",
        "access_tier": "free",
        "endpoints": [
          "/v1/pulse/whales"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free live whale movement Pulse feed.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "pulse_dormant",
        "access_tier": "free",
        "endpoints": [
          "/v1/pulse/dormant"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free live dormant-coin reactivation Pulse feed.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "pulse_consolidations",
        "access_tier": "free",
        "endpoints": [
          "/v1/pulse/consolidations"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free live consolidation-candidate Pulse feed.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "pulse_summary",
        "access_tier": "free",
        "endpoints": [
          "/v1/pulse/summary"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free live on-chain Pulse scanner health summary.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "dormancy_flushes",
        "access_tier": "free",
        "endpoints": [
          "/v1/chain/dormancy-flushes"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free classifier for long-dormant coins moving \u2014 likely sell pressure versus internal housekeeping.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "exchange_flows_summary",
        "access_tier": "free",
        "endpoints": [
          "/v1/exchange/flows/summary"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free aggregate exchange-flow teaser with full label-DB coverage metadata.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "pool_list",
        "access_tier": "free",
        "endpoints": [
          "/v1/pools/list"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free mining-pool roster with label coverage and recent block-share windows.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "pool_detail",
        "access_tier": "free",
        "endpoints": [
          "/v1/pools/{pool_name}"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free mining-pool detail with aliases, payout addresses, and recent attributed blocks.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "dormancy_whale_wakeups",
        "access_tier": "free",
        "endpoints": [
          "/v1/dormancy/whale-wakeups"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free Dormancy Watch whale-wakeup event feed.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "dormancy_watchlist",
        "access_tier": "free",
        "endpoints": [
          "/v1/dormancy/watchlist"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free Dormancy Watch observatory watchlist.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "dormancy_weekly",
        "access_tier": "free",
        "endpoints": [
          "/v1/dormancy/weekly.json",
          "/v1/dormancy/weekly.md"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free Dormancy Watch weekly rollup and X-native prose.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "tx_status",
        "access_tier": "free",
        "endpoints": [
          "/v1/tx/{txid}/status"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free Bitcoin transaction status lookup.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "op_return_decode",
        "access_tier": "free",
        "endpoints": [
          "/v1/tx/{txid}/op-return"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Free OP_RETURN and inscription-envelope protocol decode.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier": "beta_free",
        "currently_billable": false
      },
      {
        "capability": "tx_broadcast",
        "access_tier": "free",
        "endpoints": [
          "POST /v1/tx/broadcast"
        ],
        "future_native_l402_price_sats": 0,
        "price_unit": "request",
        "summary": "Signed Bitcoin transaction broadcast with API-key access by default and optional anonymous throttling.",
        "target_access_model": "free",
        "live_access_model": "free",
        "current_access_tier

… truncated here: the card is 107,713 characters as printed. The complete card is published at https://satoshidata.ai/.well-known/agent-card.json.