Actions with proxies
Updated:
Keep your proxies working after the purchase: renew them, turn on auto-renewal, replace addresses that do not work, buy more residential traffic.
The flow
Extend proxies
POST /orders/{id}/items/{line_id}/renewRenew an order line or selected addresses before they expire. Paid with x402.
Autoextend proxies
PATCH /orders/{id}withauto_renew: trueRenew automatically from your balance on the expiry date. Top up the balance with
POST /topup.IP replacement
POST /orders/{id}/replaceAsk for new addresses instead of the ones that do not work. Free of charge.
Add traffic
POST /orders/{id}/trafficAdd gigabytes to your residential package. Paid with x402.
Common to all actions
Base URL
https://proxy-seller.com/api/x402/v1Authentication
The access token of the order: Authorization: Bearer <access_token>. Paid actions must be paid from the wallet that paid the order; another wallet gets 402 payment_invalid before any funds are taken.
Result
Paid actions return 202 without a new token. Their result appears in the order: renewals[] or traffic_topups[] of Get order, and in its events.
Action | IPv4, ISP, IPv6 | 100% Uptime | MOBILE | MIX, MIX_ISP | RESIDENT |
|---|---|---|---|---|---|
Renewal | Line or selected addresses | Line or selected addresses | Line or selected addresses | Whole line only | No, buy traffic |
Auto-renewal | Yes | Yes | Yes | Yes | No |
IP replacement | Yes | No | Yes, the modem port changes | Yes | No, use a new session |
Traffic | — | — | — | — | Yes |
FAQ
No. Once all addresses of a line have expired, renew is rejected: place a new order. A residential package is different: buying traffic revives it.
No. The same addresses get a later expiry date. Check GET /orders/{id} for the current proxies and credentials.
Once in 24 hours per address.
Manual renewal is paid with x402 directly. The balance is used only by auto-renewal.