PRIVATE POOL API

Name: Private Pool API
Brand: Proxies.sx
Price: 4.00 USD
Availability: InStock

Same network, same balance at $4.00/GB, same country rates and the same username DSL as the Pool Gateway. What Private Pool adds is named, country-scoped credentials - one per project or per customer, each with its own usage series - and Reserved IPs, specific exit devices held for you alone.

Not a Private modem. Private Pool = scoped credentials and Reserved IPs on the metered network. A whole dedicated 4G/5G modem with unlimited traffic, rented per day, week or month, is a Private modem: /modems/.

This page is a pointer, not a second manual. The product, pricing and the username DSL are documented once on the Pool Gateway page and in /pool/skill.md. Only what is genuinely different lives here.

What is different

Scoped credential. A pool is pinned to a country list you choose, with its own label, its own secret, and its own per-day usage series - so you can bill or debug one project without untangling it from the rest of your traffic.
Reserved IPs (leases). A lease holds one specific exit device exclusively - nobody else is routed through it while you hold it. Pin with -pin-lease-<leaseId>. Rotating a lease swaps the device but keeps the id, so your connection string never changes.
Two funding models. A pool draws either on your account's global GB, or on a specific purchase claimed by that pool. Which one you have changes what runs out first, and what a GB of traffic uses: a pool built from balance uses 1.00, 0.375 or 0.1875 GB of balance per GB by exit country (Premium, Plus, Standard), while a purchase-funded pool counts raw GB against its own cap.
Delete a pool. DELETE /v1/private-pool/:id disables the pool's key and releases its Reserved IPs. A purchase-funded pool that still has a key is refused with a pointer to support, because it holds prepaid GB.
24 REST endpoints to create, scope, meter, reveal, rotate and lease - all with an ordinary account API key.

Start here

/private-pool/skill.md - the canonical, machine-readable reference: auth, every endpoint with real response shapes, the funding-model table, leases, and the error codes. Written for agents; equally readable by humans.

curl -s https://api.proxies.sx/v1/private-pool/pools \
  -H "X-API-Key: psx_YOUR_KEY"

Returns every pool you own, each with a ready-to-use connection block. Mint a key at client.proxies.sx/account; manage pools at client.proxies.sx/private-pool.

Exit IPs are not published: the only address the API returns is observedIp on a reservation your own pool currently holds; everywhere else you get country, carrier, ASN and type. Published exit IPs get burned by anti-bot IP-reputation systems, which would degrade the network for every customer on it.

PRIVATE POOL API

What is different

Start here

See also