{
  "openapi": "3.1.0",
  "info": {
    "title": "bitcoind.app Bitcoin Core RPC API",
    "version": "1.0.0",
    "description": "Structured Bitcoin Core RPC reference. Free tier for single lookups (100/hr per IP). Paid tiers via x402 for bulk access and search. Payments settle in USDC on Base via the x402 protocol.",
    "contact": {
      "url": "https://bitcoind.app"
    },
    "license": {
      "name": "MIT"
    }
  },
  "servers": [
    {
      "url": "https://bitcoind.app/api/v1"
    }
  ],
  "paths": {
    "/methods/{name}": {
      "get": {
        "summary": "Look up a single RPC method by name",
        "description": "Free tier. Rate limited to 100 requests per hour per IP. Returns full method details including parameters, return schema, and code examples in curl, Python, and JavaScript.",
        "parameters": [
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "RPC method name (e.g. getblockchaininfo)"
          }
        ],
        "responses": {
          "200": {
            "description": "Method details"
          },
          "404": {
            "description": "Method not found"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        },
        "x-x402": {
          "tier": "free"
        }
      }
    },
    "/categories": {
      "get": {
        "summary": "List all RPC method categories with counts",
        "description": "Free tier. Rate limited.",
        "responses": {
          "200": {
            "description": "List of categories"
          }
        },
        "x-x402": {
          "tier": "free"
        }
      }
    },
    "/openapi": {
      "get": {
        "summary": "This OpenAPI schema",
        "description": "Free. Machine-readable API description for agents.",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1 schema"
          }
        },
        "x-x402": {
          "tier": "free"
        }
      }
    },
    "/methods": {
      "get": {
        "summary": "Bulk list of all 142 RPC method summaries",
        "description": "Paid tier via x402. One call replaces up to 142 individual lookups.",
        "responses": {
          "200": {
            "description": "Array of method summaries"
          },
          "402": {
            "description": "Payment required (PAYMENT-REQUIRED header with payment instructions)"
          }
        },
        "x-x402": {
          "tier": "paid",
          "price": "$0.001",
          "network": "eip155:8453",
          "scheme": "exact"
        }
      }
    },
    "/methods/search": {
      "get": {
        "summary": "Search and filter RPC methods",
        "description": "Paid tier via x402. Filter by category, keyword, or parameter name.",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Text query across method name and summary"
          },
          {
            "name": "param",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Filter by parameter name"
          },
          {
            "name": "examples",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "description": "Include code examples"
          }
        ],
        "responses": {
          "200": {
            "description": "Filtered array of methods"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-x402": {
          "tier": "paid",
          "price": "$0.001",
          "network": "eip155:8453",
          "scheme": "exact"
        }
      }
    },
    "/dump": {
      "get": {
        "summary": "Complete structured dump of all RPC methods",
        "description": "Paid tier via x402. Returns every method with full parameters, return schemas, and code examples. One call gets everything.",
        "responses": {
          "200": {
            "description": "Complete reference"
          },
          "402": {
            "description": "Payment required"
          }
        },
        "x-x402": {
          "tier": "paid_bulk",
          "price": "$0.01",
          "network": "eip155:8453",
          "scheme": "exact"
        }
      }
    }
  },
  "x-x402": {
    "protocol_version": 2,
    "facilitator_testnet": "https://x402.org/facilitator",
    "facilitator_mainnet": "https://api.cdp.coinbase.com/platform/v2/x402",
    "settlement_asset": "USDC",
    "supported_networks": [
      "eip155:8453",
      "eip155:84532"
    ],
    "headers": {
      "request": "PAYMENT-SIGNATURE",
      "requirements": "PAYMENT-REQUIRED",
      "response": "PAYMENT-RESPONSE"
    },
    "bazaar_discoverable": true
  }
}