{
  "agentsJson": "0.1.0",
  "info": {
    "title": "SatoshiData.ai Agent API",
    "version": "2026-04-30",
    "description": "Bitcoin chain intelligence API for AI agents, developers, and applications. Use it for wallet trust and safety checks, entity labels, on-chain network context, transaction status, timestamping, and payment-aware premium intelligence."
  },
  "name": "satoshidata-ai",
  "description": "Bitcoin chain intelligence API: wallet risk and trust tiers, entity label evidence, on-chain analytics, transaction lookup, timestamping, and micropayment-gated premium intelligence.",
  "homepage_url": "https://satoshidata.ai/",
  "base_url": "https://satoshidata.ai",
  "openapi_url": "https://satoshidata.ai/openapi.json",
  "llms_txt_url": "https://satoshidata.ai/llms.txt",
  "llms_full_url": "https://satoshidata.ai/llms-full.txt",
  "agent_card_url": "https://satoshidata.ai/.well-known/agent-card.json",
  "capabilities_url": "https://satoshidata.ai/v1/capabilities",
  "mcp": {
    "url": "https://satoshidata.ai/mcp/",
    "well_known_url": "https://satoshidata.ai/.well-known/mcp.json",
    "transport": "streamable-http"
  },
  "capability_tags": [
    "bitcoin",
    "on-chain-intelligence",
    "wallet-risk",
    "trust-safety",
    "entity-labels",
    "mempool",
    "fees",
    "transaction-lookup",
    "timestamping",
    "x402",
    "L402",
    "MCP"
  ],
  "authentication": [
    {
      "type": "none",
      "description": "Free endpoints can be called without authentication. Rate limits still apply."
    },
    {
      "type": "api_key",
      "header": "X-WR-API-Key",
      "description": "Monthly or prepaid API key for paid endpoints.",
      "obtain_url": "https://satoshidata.ai/v1/billing/checkout"
    },
    {
      "type": "L402",
      "protocol": "Lightning",
      "header": "Authorization",
      "description": "Lightning pay-per-call. Send request, receive 402 with invoice, pay invoice, replay with macaroon and preimage."
    },
    {
      "type": "x402",
      "protocol": "USDC on Base",
      "header": "X-PAYMENT",
      "description": "Inline USDC micropayment for supported endpoints."
    }
  ],
  "payment_options": [
    {
      "type": "x402",
      "asset": "USDC",
      "network": "Base",
      "price": "0.01 USD",
      "status": "live on supported standard endpoints"
    },
    {
      "type": "L402",
      "asset": "BTC Lightning",
      "price_range_sats": "5-500",
      "status": "live on paid tiers"
    },
    {
      "type": "api_key",
      "price": "4.99 USD/month",
      "status": "live via checkout"
    }
  ],
  "sources": [
    {
      "id": "satoshidata-openapi",
      "path": "https://satoshidata.ai/openapi.json"
    }
  ],
  "overrides": [],
  "flows": [
    {
      "id": "wallet_trust_safety",
      "title": "Check Bitcoin Wallet Trust And Safety",
      "description": "Return the free trust tier, label evidence tier, risk flags, and caveats for a Bitcoin address.",
      "actions": [
        {
          "id": "wallet_trust_safety_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "wallet_trust_safety_v1_wallets__address__trust_safety_get"
        }
      ],
      "links": [
        {
          "origin": {
            "actionId": "wallet_trust_safety",
            "fieldPath": "parameters"
          },
          "target": {
            "actionId": "wallet_trust_safety_action",
            "fieldPath": "parameters"
          }
        }
      ],
      "fields": {
        "parameters": [
          {
            "name": "address",
            "description": "Bitcoin address to score.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "success": {
            "type": "object",
            "description": "Trust-safety response with score, category, evidence tier, caveats, and upgrade links.",
            "example": {
              "address": "bc1qexample...",
              "category": "exchange_customer",
              "confidence": "inferred",
              "risk_tier": "medium",
              "evidence_tier": "inferred"
            }
          }
        }
      }
    },
    {
      "id": "wallet_summary_paid",
      "title": "Get Paid Wallet Summary",
      "description": "Return a richer wallet intelligence summary when the caller has an API key, L402 proof, or x402 payment.",
      "actions": [
        {
          "id": "wallet_summary_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "wallet_summary_v1_wallets__address__summary_get"
        }
      ],
      "links": [
        {
          "origin": {
            "actionId": "wallet_summary_paid",
            "fieldPath": "parameters"
          },
          "target": {
            "actionId": "wallet_summary_action",
            "fieldPath": "parameters"
          }
        }
      ],
      "fields": {
        "parameters": [
          {
            "name": "address",
            "description": "Bitcoin address to summarize.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "success": {
            "type": "object",
            "description": "Wallet intelligence summary with label evidence, balances, activity, and risk context.",
            "example": {
              "address": "bc1qexample...",
              "labels": [],
              "trust_score": 72,
              "payment": "api-key-or-402"
            }
          }
        }
      }
    },
    {
      "id": "batch_trust_safety",
      "title": "Batch Wallet Trust Checks",
      "description": "Score multiple Bitcoin addresses in one request. Use this when an agent has a list of addresses to triage.",
      "actions": [
        {
          "id": "batch_trust_safety_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "wallet_batch_trust_safety_v1_batch_trust_safety_post"
        }
      ],
      "links": [
        {
          "origin": {
            "actionId": "batch_trust_safety",
            "fieldPath": "requestBody"
          },
          "target": {
            "actionId": "batch_trust_safety_action",
            "fieldPath": "requestBody"
          }
        }
      ],
      "fields": {
        "requestBody": {
          "type": "object",
          "description": "JSON body with an addresses array.",
          "example": {
            "addresses": [
              "bc1qexample1...",
              "bc1qexample2..."
            ]
          }
        },
        "responses": {
          "success": {
            "type": "object",
            "description": "Per-address trust-safety results.",
            "example": {
              "results": []
            }
          }
        }
      }
    },
    {
      "id": "bitcoin_network_snapshot",
      "title": "Get Bitcoin Network Snapshot",
      "description": "Fetch current Bitcoin price, fee, mempool, and chain summary context for a market or wallet answer.",
      "actions": [
        {
          "id": "network_summary_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "free_network_summary_v1_network_summary_get"
        }
      ],
      "links": [],
      "fields": {
        "parameters": [],
        "responses": {
          "success": {
            "type": "object",
            "description": "Current network summary.",
            "example": {
              "price": {},
              "fees": {},
              "mempool": {},
              "chain": {}
            }
          }
        }
      }
    },
    {
      "id": "exchange_flows_summary",
      "title": "Summarize Exchange Flows",
      "description": "Fetch an aggregate exchange inflow/outflow teaser for current market context.",
      "actions": [
        {
          "id": "exchange_flows_summary_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "free_exchange_flows_summary_v1_exchange_flows_summary_get"
        }
      ],
      "links": [],
      "fields": {
        "parameters": [],
        "responses": {
          "success": {
            "type": "object",
            "description": "Aggregate exchange flow summary.",
            "example": {
              "window": "24h",
              "inflow_btc": 0,
              "outflow_btc": 0
            }
          }
        }
      }
    },
    {
      "id": "bitcoin_tx_status_or_broadcast",
      "title": "Check Or Broadcast Bitcoin Transactions",
      "description": "Use status lookup for an existing txid; use broadcast only when the caller supplies a fully signed raw transaction hex.",
      "actions": [
        {
          "id": "tx_status_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "free_tx_status_v1_tx__txid__status_get"
        },
        {
          "id": "tx_broadcast_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "tx_broadcast_v1_tx_broadcast_post"
        }
      ],
      "links": [],
      "fields": {
        "parameters": [
          {
            "name": "txid",
            "description": "Transaction id for status lookup.",
            "required": false,
            "type": "string"
          },
          {
            "name": "raw_tx",
            "description": "Signed raw transaction hex for broadcast.",
            "required": false,
            "type": "string"
          }
        ],
        "responses": {
          "success": {
            "type": "object",
            "description": "Transaction status or broadcast result.",
            "example": {
              "status": "confirmed"
            }
          }
        }
      }
    },
    {
      "id": "timestamp_hash",
      "title": "Quote And Anchor A Timestamp",
      "description": "Quote the current timestamping cost, then submit a SHA-256 hash for Bitcoin anchoring when the caller approves payment.",
      "actions": [
        {
          "id": "timestamp_quote_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "timestamp_quote_v1_timestamp_quote_get"
        },
        {
          "id": "timestamp_submit_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "submit_timestamp_v1_timestamp_post"
        }
      ],
      "links": [],
      "fields": {
        "parameters": [
          {
            "name": "hash",
            "description": "SHA-256 hash hex to anchor.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "success": {
            "type": "object",
            "description": "Timestamp quote or submitted timestamp receipt.",
            "example": {
              "hash": "00...",
              "status": "pending"
            }
          }
        }
      }
    },
    {
      "id": "submit_feedback",
      "title": "Submit Data Correction Feedback",
      "description": "Let an agent report an address-label correction, endpoint issue, or evidence caveat for review.",
      "actions": [
        {
          "id": "feedback_action",
          "sourceId": "satoshidata-openapi",
          "operationId": "submit_feedback_v1_feedback_post"
        }
      ],
      "links": [],
      "fields": {
        "requestBody": {
          "type": "object",
          "description": "Machine-readable correction or issue report.",
          "example": {
            "kind": "label_correction",
            "address": "bc1qexample...",
            "message": "This address appears to belong to a different entity."
          }
        },
        "responses": {
          "success": {
            "type": "object",
            "description": "Feedback receipt.",
            "example": {
              "ok": true
            }
          }
        }
      }
    }
  ]
}