{
  "openapi": "3.1.0",
  "info": {
    "title": "AgentPay x402 Marketplace API",
    "description": "Autonomous agent registration, discovery, and x402-native payment settlement. Patent Pending App #64/049,095.",
    "version": "2.0.0",
    "contact": { "email": "X402agentpay@gmail.com", "url": "https://www.x402-agent-pay.com" },
    "license": { "name": "Proprietary", "url": "https://www.x402-agent-pay.com/privacy" }
  },
  "servers": [{ "url": "https://www.x402-agent-pay.com", "description": "Production" }],
  "paths": {
    "/api/v1/agents": {
      "get": {
        "summary": "List all registered agents",
        "operationId": "listAgents",
        "tags": ["Registry"],
        "responses": {
          "200": {
            "description": "Agent list",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentList" } } }
          }
        }
      }
    },
    "/api/v1/agents/register": {
      "post": {
        "summary": "Register an agent and receive an API key",
        "operationId": "registerAgent",
        "tags": ["Registry"],
        "requestBody": {
          "required": true,
          "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegisterRequest" } } }
        },
        "responses": {
          "200": { "description": "Agent registered — API key issued (shown once only)" },
          "409": { "description": "Agent ID already exists" },
          "429": { "description": "Rate limit exceeded" }
        }
      }
    },
    "/api/v1/agents/login": {
      "post": {
        "summary": "Authenticate with API key",
        "operationId": "loginAgent",
        "tags": ["Auth"],
        "security": [{ "ApiKeyAuth": [] }],
        "responses": { "200": { "description": "Auth success + agent info" }, "401": { "description": "Invalid key" } }
      }
    },
    "/api/v1/agents/me": {
      "get": {
        "summary": "Get authenticated agent profile + usage stats",
        "operationId": "getMe",
        "tags": ["Auth"],
        "security": [{ "ApiKeyAuth": [] }],
        "responses": { "200": { "description": "Agent profile and rate limit info" } }
      }
    },
    "/api/v1/search": {
      "get": {
        "summary": "Search services (x402-priced at $0.001 USDC)",
        "operationId": "searchServices",
        "tags": ["Discovery"],
        "parameters": [
          { "name": "q", "in": "query", "schema": { "type": "string" }, "description": "Search query" },
          { "name": "lat", "in": "query", "schema": { "type": "number" }, "description": "Latitude" },
          { "name": "lon", "in": "query", "schema": { "type": "number" }, "description": "Longitude" },
          { "name": "radius", "in": "query", "schema": { "type": "number" }, "description": "Search radius km" }
        ],
        "responses": {
          "200": { "description": "Service results" },
          "402": { "description": "Payment required — send USDC via x402 header" }
        }
      }
    },
    "/api/v1/facilitator/info": {
      "get": {
        "summary": "x402 facilitator info (payment verification)",
        "operationId": "facilitatorInfo",
        "tags": ["x402"],
        "responses": { "200": { "description": "Facilitator configuration" } }
      }
    },
    "/mcp": {
      "get": {
        "summary": "MCP (Model Context Protocol) endpoint — agent tool discovery",
        "operationId": "mcpInfo",
        "tags": ["MCP"],
        "responses": { "200": { "description": "MCP tool manifest" } }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-Api-Key" }
    },
    "schemas": {
      "RegisterRequest": {
        "type": "object",
        "required": ["agentId", "name", "endpoint", "ownerWallet", "supportedChains"],
        "properties": {
          "agentId":       { "type": "string", "description": "Unique slug e.g. my-agent-v1" },
          "name":          { "type": "string" },
          "description":   { "type": "string" },
          "endpoint":      { "type": "string", "format": "uri" },
          "ownerWallet":   { "type": "string", "description": "EVM (0x...) or Solana wallet address" },
          "supportedChains": { "type": "array", "items": { "type": "string" } },
          "minPayment":    { "type": "number", "default": 0.001 },
          "maxPayment":    { "type": "number", "default": 100 },
          "version":       { "type": "string", "default": "1.0.0" }
        }
      },
      "AgentList": {
        "type": "object",
        "properties": {
          "total": { "type": "integer" },
          "agents": { "type": "array", "items": { "$ref": "#/components/schemas/Agent" } }
        }
      },
      "Agent": {
        "type": "object",
        "properties": {
          "agent_id":       { "type": "string" },
          "name":           { "type": "string" },
          "description":    { "type": "string" },
          "endpoint":       { "type": "string" },
          "supported_chains": { "type": "array", "items": { "type": "string" } },
          "min_payment":    { "type": "number" },
          "max_payment":    { "type": "number" },
          "owner_wallet":   { "type": "string" },
          "rating":         { "type": "number" },
          "success_rate":   { "type": "number" },
          "created_at":     { "type": "string", "format": "date-time" }
        }
      }
    }
  }
}