{"openapi":"3.1.0","info":{"title":"PinguProxy Agent API","version":"1.0.0","description":"Buy PinguProxy proxies with USDC on Base via x402: rotating residential proxies by the GB (PAYG, 1-200 GB, credits never expire, country targeting) and 30-day datacenter proxy passes (Basic, Pro, Enterprise), HTTP and SOCKS5, for web scraping and automation. Quote first, then pay per order; credentials are collected by polling the order.","contact":{"name":"PinguProxy","url":"https://pinguproxy.com/contact","email":"info@pinguproxy.com"},"x-guidance":"1) GET /agent/v1/quote (free) locks the price for 300 seconds. 2) POST /agent/v1/orders with X-Quote-Id and Idempotency-Key: the unpaid call returns 402 with the exact USDC amount on Base; pay and retry with PAYMENT-SIGNATURE. 3) GET /agent/v1/orders/{order_id} with X-Order-Secret collects the proxy credentials and the agent API key. Full guidance: https://api.pinguproxy.com/llms.txt"},"x-agentcash-guidance":{"llmsTxtUrl":"https://api.pinguproxy.com/llms.txt"},"x-agentcash-provenance":{"ownershipProofs":["0x3251503d13dd598d2Fc4de31458e1c3eaFfd626e","https://api.pinguproxy.com/.well-known/x402"]},"servers":[{"url":"https://api.pinguproxy.com"}],"tags":[{"name":"agent","description":"PinguProxy agent API (x402)"},{"name":"proxy"},{"name":"residential proxy"},{"name":"datacenter proxy"},{"name":"rotating proxy"},{"name":"web scraping"},{"name":"http proxy"},{"name":"socks5"}],"paths":{"/agent/v1/health":{"get":{"operationId":"agentHealth","summary":"Agent API health and configuration","description":"Free. API version, UTC clock, x402 settings and the EUR/USD rate currently used for pricing.","tags":["agent","proxy"],"security":[],"responses":{"200":{"description":"Agent API status"}}}},"/agent/v1/catalog":{"get":{"operationId":"agentCatalog","summary":"Sellable products and current USD prices","description":"Free. 30-day datacenter proxy passes and the residential PAYG GB tiers with indicative USD prices derived from the live EUR prices, the ECB EUR/USD rate and the declared buffer. Quote for the exact locked amount.","tags":["agent","proxy","residential proxy","datacenter proxy","rotating proxy","web scraping","http proxy","socks5"],"security":[],"responses":{"200":{"description":"Catalog"},"503":{"description":"EUR/USD rate unavailable (pricing is fail-closed)"}}}},"/agent/v1/quote":{"get":{"operationId":"agentQuote","summary":"Lock a price for 300 seconds","description":"Free. Returns a quote id and the exact USD/USDC amount for one product. The quote expires after 300 seconds and is consumed by the order it pays for.","tags":["agent","proxy","residential proxy","datacenter proxy","rotating proxy","web scraping","http proxy","socks5"],"security":[],"parameters":[{"name":"sku","in":"query","required":true,"description":"Product family to quote.","schema":{"type":"string","enum":["payg","plan"]}},{"name":"gb","in":"query","required":false,"description":"Prepaid GB for sku=payg (whole number).","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"plan_id","in":"query","required":false,"description":"Datacenter plan id for sku=plan (30-day plans only).","schema":{"type":"integer"}}],"responses":{"200":{"description":"Locked quote"},"404":{"description":"Unknown plan"},"409":{"description":"Plan not sellable to agents"},"422":{"description":"Invalid parameters"},"429":{"description":"Rate limit exceeded"},"503":{"description":"EUR/USD rate unavailable (pricing is fail-closed)"}}}},"/agent/v1/orders":{"post":{"operationId":"agentCreateOrder","summary":"Buy residential proxy GB or a 30-day datacenter proxy pass","description":"Paid with x402 (USDC on Base, scheme exact). Send X-Quote-Id from GET /agent/v1/quote and a unique Idempotency-Key. The unpaid call returns 402 with the payment requirements; the paid call creates the order and returns order_id and order_secret. Credentials are collected from the order once the payment settles.","tags":["agent","proxy","residential proxy","datacenter proxy","rotating proxy","web scraping","http proxy","socks5"],"security":[],"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"2.24","max":"358.77"},"protocols":[{"x402":{}}]},"parameters":[{"name":"X-Quote-Id","in":"header","required":true,"description":"Quote id from GET /agent/v1/quote (locks the price).","schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique key for this purchase; a retry with the same key never pays twice.","schema":{"type":"string","maxLength":128}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"Order created (pending settlement)"},"400":{"description":"Missing or malformed headers"},"402":{"description":"Payment required: PAYMENT-REQUIRED carries the x402 requirements (USDC on Base)"},"409":{"description":"Quote expired, already consumed or conflicting replay"},"429":{"description":"Rate limit exceeded"}}}},"/agent/v1/orders/{order_id}":{"get":{"operationId":"agentGetOrder","summary":"Order status, credentials and agent key","description":"Free. Poll with the X-Order-Secret returned by the order creation (first collection), or with the agent API key for later reads. Returns the proxy credentials once fulfilled; the agent API key is returned for the account's first order.","tags":["agent","proxy"],"security":[],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Order-Secret","in":"header","required":false,"description":"One-time secret returned when the order was created.","schema":{"type":"string"}},{"name":"X-Idempotency-Key","in":"header","required":false,"description":"Recovery only: the order's Idempotency-Key, accepted to re-issue the secret when the original response was lost.","schema":{"type":"string"}}],"responses":{"200":{"description":"Order status"},"403":{"description":"Order secret or agent key required"},"404":{"description":"Order not found"}}}},"/agent/v1/orders/{order_id}/refund":{"post":{"operationId":"agentRefundOrder","summary":"Request the automatic PAYG credit for an unfulfilled order","description":"Free. An order that was paid but could not be fulfilled is credited back to the agent's PAYG balance (GB at the PAYG list price); there are no on-chain refunds and no manual review. Keep the order secret or the agent API key to call it.","tags":["agent","proxy"],"security":[],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Order-Secret","in":"header","required":false,"description":"One-time secret returned when the order was created.","schema":{"type":"string"}}],"responses":{"200":{"description":"Refund credited"},"403":{"description":"Order secret or agent key required"},"404":{"description":"Order not found"},"409":{"description":"Order not refundable or refund window expired"}}}}}}