PinguProxy for AI agents
An autonomous agent can buy proxies from PinguProxy with no account, card or API key: it pays in USDC on Base with the x402 protocol and collects the credentials from the API at api.pinguproxy.com.
What an agent can buy
- Residential proxies by the GB (PAYG): rotating residential IPs, prepaid in whole GB from 1 to 200. Credits never expire; the service stops at a zero balance.
- 30-day datacenter proxy passes: Basic, Pro and Enterprise. One proxy credential, valid for 30 days, no automatic renewal.
- Every credential works over HTTP and SOCKS5.
| Tier (GB) | Example order | USD | USD per GB | EUR list price |
|---|---|---|---|---|
| 1-9 | 1 GB | $2.24 | $2.24 | €1.99 |
| 10-19 | 10 GB | $20.18 | $2.02 | €17.99 |
| 20-29 | 20 GB | $38.11 | $1.91 | €33.99 |
| 30-39 | 30 GB | $54.93 | $1.84 | €48.99 |
| 40-49 | 40 GB | $72.87 | $1.83 | €64.99 |
| 50-59 | 50 GB | $90.81 | $1.82 | €80.99 |
| 60-200 | 60 GB | $107.63 | $1.80 | €95.99 |
| Pass | plan_id | Days | USD | EUR list price |
|---|---|---|---|---|
| Basic 1 Month | 1 | 30 | $16.81 | €14.99 |
| Pro 1 Month | 4 | 30 | $28.02 | €24.99 |
| Enterprise 1 Month | 7 | 30 | $50.45 | €44.99 |
Prices from the live catalog: EUR list prices converted at the ECB EUR/USD rate of 2026-11-19 (1.0992) plus the declared buffer. The quote gives the exact amount you pay.
How the x402 purchase works
1. Catalog
GET /agent/v1/catalogFree. Lists the products, the live USD prices and the accepted payment: x402, scheme exact, USDC on Base (eip155:8453).
2. Quote
GET /agent/v1/quote?sku=payg&gb=5Free. Locks the exact USDC amount for 300 seconds and returns a quote_id. Use sku=plan&plan_id=N for a 30-day pass. POST with a JSON body works too.
3. 402
POST /agent/v1/ordersSend X-Quote-Id and a unique Idempotency-Key. Without payment the API answers 402 Payment Required with the PAYMENT-REQUIRED header for the quoted amount.
4. Payment
POST /agent/v1/orders + PAYMENT-SIGNATURESign the payment with any x402 client and repeat the same request. The response carries order_id and a one-time order_secret.
5. Delivery
GET /agent/v1/orders/{order_id}Poll with the X-Order-Secret header: once the payment settles you get the proxy host, port, username and password, plus an agent API key for later reads.
A payment without a quote is never settled, and a retry with the same Idempotency-Key never pays twice. An order that is paid but cannot be fulfilled is credited back to the agent's PAYG balance.
Example
The free steps with curl:
curl https://api.pinguproxy.com/agent/v1/catalog
curl "https://api.pinguproxy.com/agent/v1/quote?sku=payg&gb=5"
curl -i -X POST https://api.pinguproxy.com/agent/v1/orders \
-H "X-Quote-Id: <quote_id>" -H "Idempotency-Key: my-order-0001"
# -> HTTP/1.1 402 Payment Required, PAYMENT-REQUIRED: <x402 requirements>The full purchase in Python with the x402 SDK (pip install x402 httpx eth-account):
import httpx
from eth_account import Account
from x402 import x402ClientSync
from x402.http.x402_http_client import x402HTTPClientSync
from x402.mechanisms.evm.exact import ExactEvmClientScheme
BASE = "https://api.pinguproxy.com"
account = Account.from_key(PRIVATE_KEY) # a wallet with USDC on Base
payer = x402ClientSync()
payer.register("eip155:8453", ExactEvmClientScheme(signer=account))
http_payer = x402HTTPClientSync(payer)
with httpx.Client(base_url=BASE, timeout=60) as api:
# 1-2. free quote: the price is locked for 300 seconds
quote = api.get("/agent/v1/quote", params={"sku": "payg", "gb": 5}).json()
headers = {"X-Quote-Id": quote["quote_id"], "Idempotency-Key": "my-order-0001"}
# 3. the unpaid call answers 402 with the exact USDC amount
unpaid = api.post("/agent/v1/orders", headers=headers)
assert unpaid.status_code == 402
# 4. sign the payment and repeat the same request
payment_headers, _ = http_payer.handle_402_response(
dict(unpaid.headers), unpaid.content, f"{BASE}/agent/v1/orders"
)
order = api.post("/agent/v1/orders", headers={**headers, **payment_headers}).json()
# 5. collect the credentials once the payment has settled
status = api.get(
f"/agent/v1/orders/{order['order_id']}",
headers={"X-Order-Secret": order["order_secret"]},
).json()
print(status["status"], status.get("credentials"))Machine-readable entry points
- x402 manifest: https://api.pinguproxy.com/.well-known/x402
- OpenAPI: https://api.pinguproxy.com/openapi.json
- llms.txt: https://api.pinguproxy.com/llms.txt
- Catalog: https://api.pinguproxy.com/agent/v1/catalog
- Terms for automated clients: Agent Access Addendum