API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Selling platform

Let a customer get a new IP for the proxy they rent, with its token link

Rotates the slot behind one sold proxy. Works only when the seller allowed API rotation for that proxy and the last rotation is older than its minimum interval; group proxies are refused. Refusals come in data (not allowed) or message (all others).

  • Action · reversible
  • Selling token (?token=)
  • Public API · since v20.8.0
  • Hub: needs owner approval
  • rotateSellingProxyIp
GET/selling/rotate

Query parameters

tokenstringrequiredsecret

API token of one sold proxy (api_token in /selling/shared_proxies). Give it only to the customer who rents that proxy; anyone with the link can use it.

Authentication

Authenticated only by the sold proxy's API token; the dashboard login and "Basic auth for all API" do not apply.

Responses

Rotation result or refusal.

Errors returned in msg

msgMeaningWhat to do
This function is available on Selling Platform license only. Please contact Administrator!The license does not include the Selling Platform.Upgrade the license.
API Token invalidToken unknown or reset (in message).Ask the seller for the current link; tokens change when reset.
Feature does not allowed for proxy groupThe proxy is a group proxy (in data).Not available for group proxies.
Feature does not allowedThe seller did not allow API rotation (in data).Ask the seller to enable it.
Please waiting for next: N secondsMinimum rotation interval not reached.Wait N seconds.
Proxy is not ready, try again later!The slot has no modem right now.Retry later.
MODEM_STOPPEDRotation refused by the slot (code from the rotation itself, in message).Contact the seller.
Try again later!Unexpected error.Retry later.
Verified against XProxy v21.3.2 on Nov 17, 2026