Proxy302 API documentation

Every endpoint answers HTTP 200 and reports the outcome in the {code, msg, data} envelope: code === 0 means success; data is null on every non-zero code. Money is PTC with at most 3 decimals, traffic volumes are decimal byte strings, timestamps are Unix seconds.

Auth

Issue the Basic credential and inspect the current API key identity.

  • GET /open_api/v3/user/users/token — Encode the key into the Authorization: Basic header value
  • GET /open_api/v3/user/users/me — Current API key identity (name / email / uid)

Directory

Look up area ids and static price plans before a purchase.

  • GET /open_api/v3/proxy/area/{area_type} — List areas by granularity (country / state / city)
  • GET /open_api/v3/proxy/payway/{payway_name} — List payways (price plans) for a static product

Purchase

Four purchase lines: static traffic, static IP, dynamic traffic, dynamic by-area. Parameters go in the JSON body and/or the query string; the body wins on conflicts.

  • POST /open_api/v3/proxy/api/proxy/static/traffic — Buy static traffic proxy
  • POST /open_api/v3/proxy/api/proxy/static/ip — Buy a static IP (lease-billed)
  • POST /open_api/v3/proxy/api/proxy/dynamic/traffic — Buy dynamic traffic proxy
  • POST /open_api/v3/proxy/api/proxy/dynamic/ip/by_area — Buy dynamic IP proxy by area

Proxy list

Paged listing of owned proxies with filtering, sorting and soft-delete toggles.

  • GET /open_api/v3/proxy/tokens/{generate}/{proxy_type} — List owned proxy tokens (paged)

Traffic & usage

Day-bucketed consumption, usage chart series and pool balance.

  • GET /open_api/v3/proxy/traffic/consume/log/summary — Traffic consumption by day and pool category
  • GET /open_api/v3/proxy/summary/proxies/{proxy_type}/{statistics_type} — Usage chart series
  • GET /open_api/v3/proxy/summary/cost/{statistics_type} — Spend chart by category (PTC)
  • GET /open_api/v3/proxy/traffic/pool/remaining — Remaining traffic pool balance

Renewal

Paid static lease extension and the auto-renewal toggle.

  • POST /open_api/v3/proxy/token/renew/{token_id} — Renew a static IP (paid)
  • PUT /open_api/v3/proxy/token/renew/{token_id} — Toggle auto renewal

ISP directory

ISP options for premium dynamic targeting.

  • GET /open_api/v3/proxy/isp/catalog — List ISP targeting options (optionally by country)

Session reset

Rotate the exit IP of sticky credentials without new keys (all upstream session segments per token, 1-100 tokens).

  • DELETE /open_api/v3/proxy/sessions — Batch-reset sticky sessions (token_ids array in the body)

IP whitelist

Per-token source-IP allowlist (at most 5 IPs per token).

  • GET /open_api/v3/proxy/token/{token_id}/ip-whitelist — List the token's whitelisted IPs
  • POST /open_api/v3/proxy/token/{token_id}/ip-whitelist — Bind a source IP
  • DELETE /open_api/v3/proxy/token/{token_id}/ip-whitelist/{ip} — Unbind a source IP

Proxy302

PROXY302