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

Create new proxies to sell, on one slot each or as group proxies

Creates sold proxies (new listening ports) and starts them. With genMethod 1 it creates numberOfPorts ports per slot in selected_positions (or positionFrom..positionTo); with 2 it creates numberOfPorts ports that spread over all selected slots. Answers with the created rows, which contain credentials and API tokens. VLESS and Shadowsocks port types need a Premium or Business license and are refused with HTTP 403 otherwise.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • generateSellingProxies
POST/selling/generate

Request body application/json · required

portTypeintegeroptional

0 HTTP and SOCKS5, 1 HTTP, 2 SOCKS5, 3 VLESS (Xray), 4 Shadowsocks (Xray). 3 and 4 need a Premium or Business license.

One of 0, 1, 2, 3, 4
ipTypeintegeroptional

1 IPv4, 2 IPv6, 3 IPv6 then IPv4, 4 IPv4 then IPv6.

One of 1, 2, 3, 4
expiredDateintegerrequired

Expiry in epoch milliseconds.

ipAuthenticationEntrystringoptional

Comma-separated IPs allowed without a password.

userAuthenticationEntrystringoptional

user:pass entries.

isAutoGenAuthenticationbooleanoptional

Generate random user:pass instead of userAuthenticationEntry.

whitelistLimitAccessEntrystringoptional

Only these domains are reachable.

blacklistLimitAccessEntrystringoptional

These domains are blocked.

bwLimitEnabledintegeroptional
One of 0, 1
bwLimitRateintegeroptional

Mbps.

customDNSstringoptional
maxConnectionintegeroptional
maxConnectionPeriodintegeroptional
idleTimeoutintegeroptional
counterAllLimitintegeroptional
One of 0, 1
counterAllLimitByintegeroptional
One of 1, 2, 3, 4
counterAllQuotaInMBintegeroptional
counterDownloadLimitintegeroptional
One of 0, 1
counterDownloadLimitByintegeroptional
One of 1, 2, 3, 4
counterDownloadQuotaInMBintegeroptional
counterUploadLimitintegeroptional
One of 0, 1
counterUploadLimitByintegeroptional
One of 1, 2, 3, 4
counterUploadQuotaInMBintegeroptional
forceServerResolveDnsbooleanoptional
allowApiRotatebooleanoptional

Let the customer rotate with /selling/rotate.

minSecondRotateintegeroptional

Minimum seconds between customer rotations.

allowApiChangeRotationbooleanoptional

Let the customer set the auto-rotation interval.

intervalRotationintegeroptional

Auto-rotation interval in seconds; 0 off.

minIntervalRotationintegeroptional
sharedEnabledbooleanoptional
tcpOSstringoptional

TCP OS fingerprint profile id (see /selling/tcp_os_profiles).

memostringoptional
tagsstring[]optional
genMethodintegeroptional

1 one slot per proxy, 2 group proxy.

One of 1, 2Default 1
selected_positionsinteger[]optional

Slots to use. Without it positionFrom and positionTo are required.

positionFromintegeroptional
positionTointegeroptional
numberOfPortsintegerrequired
genPortintegeroptional

1 random ports, 2 sequential from genPortStart.

One of 1, 2Default 1
genPortStartintegeroptional
Default 20001
isAutoGenDifferenceEachPortbooleanoptional
Default true
vlessFlowstringoptional

Responses

Created rows, or the license 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.
VLESS and Shadowsocks require a Premium or Business licenseportType 3 or 4 on a license without Xray selling (HTTP 403).Use portType 0-2 or upgrade the license.
Verified against XProxy v21.3.2 on Nov 17, 2026