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.
Residential PAYG: the per-GB rate drops with each 10 GB tier
Tier (GB)Example orderUSDUSD per GBEUR list price
1-91 GB$2.24$2.24€1.99
10-1910 GB$20.18$2.02€17.99
20-2920 GB$38.11$1.91€33.99
30-3930 GB$54.93$1.84€48.99
40-4940 GB$72.87$1.83€64.99
50-5950 GB$90.81$1.82€80.99
60-20060 GB$107.63$1.80€95.99
Datacenter passes
Passplan_idDaysUSDEUR list price
Basic 1 Month130$16.81€14.99
Pro 1 Month430$28.02€24.99
Enterprise 1 Month730$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. 1. Catalog GET /agent/v1/catalog

    Free. Lists the products, the live USD prices and the accepted payment: x402, scheme exact, USDC on Base (eip155:8453).

  2. 2. Quote GET /agent/v1/quote?sku=payg&gb=5

    Free. 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. 3. 402 POST /agent/v1/orders

    Send 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. 4. Payment POST /agent/v1/orders + PAYMENT-SIGNATURE

    Sign the payment with any x402 client and repeat the same request. The response carries order_id and a one-time order_secret.

  5. 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:

shell
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):

python
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