{
  "openapi": "3.1.0",
  "info": {
    "title": "x402 Atlas",
    "version": "0.1.0",
    "description": "Live, verified search + deterministic purchase policy for x402 machine-payable APIs. All money in 6-decimal integer USDC units."
  },
  "servers": [
    {
      "url": "https://atlas.code402.dev"
    }
  ],
  "paths": {
    "/v1/search": {
      "get": {
        "summary": "Ranked search over verified x402 services",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "price_max_usd",
            "in": "query",
            "schema": {
              "type": "number"
            }
          },
          {
            "name": "alive_only",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": true
            }
          }
        ]
      }
    },
    "/v1/plan": {
      "post": {
        "summary": "Deterministic purchase gate: ACCEPT/REJECT/ESCALATE with policy checklist and surplus proof",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "endpoint_url"
                ],
                "properties": {
                  "endpoint_url": {
                    "type": "string",
                    "format": "uri"
                  },
                  "budget_usd": {
                    "type": "number"
                  },
                  "price_ceiling_usd": {
                    "type": "number"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/fee/quote": {
      "get": {
        "summary": "Deterministic signed fee quote (expires in 300s)",
        "parameters": [
          {
            "name": "notional_units",
            "in": "query",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "client",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/invite": {
      "post": {
        "summary": "Signed propagation invitation with verifiable economic surplus"
      }
    },
    "/mcp": {
      "post": {
        "summary": "MCP server: search_x402, plan_purchase, get_ecosystem_stats"
      }
    }
  }
}