{"info":{"contact":{"name":"AgentPay","url":"https://x402-agent-pay.com"},"description":"Machine-purchasable digital products via x402 USDC payments on Base L2. Browse the catalog, initiate checkout to receive payment instructions, confirm payment with tx_hash, and receive an API key for instant data access.","title":"AgentStore Digital Marketplace API","version":"2.0.0","x-payment-asset":"USDC","x-payment-network":"Base L2","x-payment-protocol":"x402"},"openapi":"3.0.0","paths":{"/api/digital/access/":{"get":{"description":"Proxy to the real data endpoint. Requires X-API-Key header from a confirmed purchase.","operationId":"accessApiEndpoint","parameters":[{"in":"header","name":"X-API-Key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Data from the purchased endpoint"},"401":{"description":"Invalid, expired, or missing API key"},"402":{"description":"Call limit reached \u2014 purchase more credits"}},"summary":"Access purchased API endpoint","tags":["Keys"]}},"/api/digital/access/verify":{"get":{"description":"Check if an issued API key is valid, the endpoint it unlocks, usage stats, and expiry.","operationId":"verifyApiKey","parameters":[{"in":"query","name":"key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"calls_limit":{"oneOf":[{"type":"integer"},{"type":"string"}]},"calls_used":{"type":"integer"},"endpoint":{"type":"string"},"expired":{"type":"boolean"},"expires_at":{"type":"integer"},"product_id":{"type":"string"},"valid":{"type":"boolean"}},"type":"object"}}},"description":"Key status"}},"summary":"Verify an API key","tags":["Keys"]}},"/api/digital/checkout":{"post":{"description":"Returns HTTP 402 with USDC payment details. Send the exact amount to receiver on Base L2, then confirm with tx_hash.","operationId":"checkoutDigitalProduct","requestBody":{"content":{"application/json":{"schema":{"properties":{"buyer_wallet":{"example":"0xYourWalletAddress","type":"string"},"product_id":{"example":"dp_aw_agents_api","type":"string"}},"required":["product_id"],"type":"object"}}},"required":true},"responses":{"402":{"content":{"application/json":{"schema":{"properties":{"next_step":{"type":"string"},"order_id":{"type":"string"},"payment_required":{"properties":{"amount_usdc":{"type":"number"},"asset":{"example":"USDC","type":"string"},"chain":{"example":"base","type":"string"},"expires_at":{"type":"integer"},"memo":{"type":"string"},"receiver":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Payment required \u2014 contains USDC amount and receiver address"}},"summary":"Initiate digital product checkout","tags":["Commerce"]}},"/api/digital/confirm":{"post":{"description":"Submit order_id and on-chain tx_hash. Receive an API key for immediate data access.","operationId":"confirmDigitalPayment","requestBody":{"content":{"application/json":{"schema":{"properties":{"order_id":{"type":"string"},"tx_hash":{"example":"0xabcd...","type":"string"}},"required":["order_id","tx_hash"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"delivery":{"properties":{"calls_limit":{"oneOf":[{"type":"integer"},{"type":"string"}]},"endpoint":{"type":"string"},"expires_at":{"type":"integer"},"expires_in":{"example":"24h","type":"string"},"key":{"example":"aw_abc123...","type":"string"},"usage":{"type":"string"},"verify":{"type":"string"}},"type":"object"},"order_id":{"type":"string"},"status":{"example":"delivered","type":"string"}},"type":"object"}}},"description":"Payment confirmed \u2014 API key delivered"}},"summary":"Confirm payment and receive API key","tags":["Commerce"]}},"/api/digital/products":{"get":{"description":"Returns all 22 available digital products with IDs, names, prices in USDC, categories, and delivery types.","operationId":"listDigitalProducts","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"products":{"items":{"properties":{"category":{"type":"string"},"delivery_type":{"type":"string"},"description":{"type":"string"},"id":{"example":"dp_aw_agents_api","type":"string"},"name":{"type":"string"},"price_usdc":{"example":0.5,"type":"number"},"provider":{"type":"string"},"rate_limit":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"Product catalog"}},"summary":"List all digital products","tags":["Commerce"]}},"/llms.txt":{"get":{"description":"Plain text instructions optimized for LLMs and AI crawlers explaining all APIs and purchase flows.","operationId":"getLlmsTxt","responses":{"200":{"description":"LLM instructions"}},"summary":"LLM-readable site instructions","tags":["Discovery"]}},"/mcp":{"get":{"description":"Returns the MCP manifest listing all available tools for AI agent discovery.","operationId":"getMcpManifest","responses":{"200":{"description":"MCP manifest"}},"summary":"MCP tool discovery manifest","tags":["Discovery"]}}},"servers":[{"description":"Production","url":"https://agentpaystore.com"}]}