Static proxies.
24-hour leases.

# cURL · review your price ceiling before purchasing.
export PREPROX_API_BASE='https://preprox.com/api/v1/marketplace'
export PREPROX_API_KEY='YOUR_PREPROX_API_KEY'

# 1. Check the wallet that will pay for this lease.
curl --fail-with-body "$PREPROX_API_BASE/account" \
  -H "Authorization: Bearer $PREPROX_API_KEY" \
  -H 'Accept: application/json'

# 2. Discover inventory and copy one available shared plan's px_ ID.
curl --fail-with-body --get "$PREPROX_API_BASE/proxies" \
  -H "Authorization: Bearer $PREPROX_API_KEY" \
  -H 'Accept: application/json' \
  --data-urlencode 'country=US' --data-urlencode 'plan=shared'

# 3. Replace the placeholder with that complete inventory ID.
curl --fail-with-body "$PREPROX_API_BASE/quotes" \
  -H "Authorization: Bearer $PREPROX_API_KEY" \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -d '{"proxy_id":"px_YOUR_INVENTORY_ID","plan":"shared"}'

# 4. This call PURCHASES a lease. Review the quote before sending.
# Replace the q_ ID. Persist a unique key and this exact body first.
# Retry the SAME body and key if this request times out.
curl --fail-with-body "$PREPROX_API_BASE/leases" \
  -H "Authorization: Bearer $PREPROX_API_KEY" \
  -H 'Accept: application/json' -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: order-YOUR_UNIQUE_ORDER_ID' \
  -d '{"quote_id":"q_YOUR_QUOTE_ID","max_price":"0.42"}'

# Python 3 · standard library · purchases ONE lease up to USD 0.42.
# Set PREPROX_API_BASE and PREPROX_API_KEY in your environment first.
import json
import os
import uuid
from decimal import Decimal
from urllib.error import HTTPError
from urllib.request import Request, urlopen

BASE = os.environ["PREPROX_API_BASE"].rstrip("/")
KEY = os.environ["PREPROX_API_KEY"]
MAX_PRICE = "0.42"  # Review this ceiling before running.

def api(method, path, body=None, purchase_key=None):
    headers = {"Authorization": f"Bearer {KEY}", "Accept": "application/json"}
    data = None if body is None else json.dumps(body).encode("utf-8")
    if data is not None:
        headers["Content-Type"] = "application/json"
    if purchase_key:
        headers["Idempotency-Key"] = purchase_key
    try:
        request = Request(BASE + path, data=data, headers=headers, method=method)
        with urlopen(request, timeout=30) as response:
            return json.load(response)
    except HTTPError as error:
        raise RuntimeError(f"HTTP {error.code}: {json.load(error)}") from error

account = api("GET", "/account")["data"]
if Decimal(account["wallet_balance"]) < Decimal(MAX_PRICE):
    raise SystemExit("Fund your PreProx wallet first.")
inventory = api("GET", "/proxies?country=US&plan=shared")
proxy = next((p for p in inventory["data"]
              if p["plans"]["shared"]["available"]
              and Decimal(p["plans"]["shared"]["amount"]) <= Decimal(MAX_PRICE)), None)
if proxy is None:
    raise SystemExit("No match on this page; check meta.next_cursor or adjust filters.")
quote = api("POST", "/quotes", {"proxy_id": proxy["id"], "plan": "shared"})["data"]
purchase_key = str(uuid.uuid4())
purchase_body = {"quote_id": quote["id"], "max_price": MAX_PRICE}
# PRODUCTION: persist purchase_key and purchase_body BEFORE sending.
# If a timeout occurs, retry with that saved key and exact body.
lease = api("POST", "/leases", purchase_body, purchase_key)["data"]
print("Lease", lease["id"], "charged", lease["amount"], lease["currency"])

// Node.js 18+ · server-side only · purchases ONE lease up to USD 0.42.
// Set PREPROX_API_BASE and PREPROX_API_KEY in your environment first.
import { randomUUID } from 'node:crypto';

const base = process.env.PREPROX_API_BASE.replace(/\/$/, '');
const key = process.env.PREPROX_API_KEY;
const maxPrice = '0.42'; // Review this ceiling before running.
const cents = value => {
  const [whole, fraction = ''] = value.split('.');
  return BigInt(whole) * 100n + BigInt(fraction.padEnd(2, '0'));
};

async function api(method, path, body, purchaseKey) {
  const response = await fetch(base + path, {
    method,
    headers: {
      Authorization: `Bearer ${key}`, Accept: 'application/json',
      ...(body ? { 'Content-Type': 'application/json' } : {}),
      ...(purchaseKey ? { 'Idempotency-Key': purchaseKey } : {}),
    },
    body: body ? JSON.stringify(body) : undefined,
    signal: AbortSignal.timeout(30000),
  });
  const result = await response.json();
  if (!response.ok) throw new Error(`HTTP ${response.status}: ${JSON.stringify(result)}`);
  return result;
}

const { data: account } = await api('GET', '/account');
if (cents(account.wallet_balance) < cents(maxPrice)) throw new Error('Fund your wallet first.');
const inventory = await api('GET', '/proxies?country=US&plan=shared');
const proxy = inventory.data.find(p => p.plans.shared.available
  && cents(p.plans.shared.amount) <= cents(maxPrice));
if (!proxy) throw new Error('No match on this page; check meta.next_cursor or adjust filters.');
const { data: quote } = await api('POST', '/quotes', { proxy_id: proxy.id, plan: 'shared' });
const purchaseKey = randomUUID();
const purchaseBody = { quote_id: quote.id, max_price: maxPrice };
// PRODUCTION: persist purchaseKey and purchaseBody BEFORE sending.
// If a timeout occurs, retry with that saved key and exact body.
const { data: lease } = await api('POST', '/leases', purchaseBody, purchaseKey);
console.log({ lease_id: lease.id, amount: lease.amount, currency: lease.currency });