An ISP proxy API lets a script buy static residential IPs without opening a dashboard. On QuanticData the flow is four calls: read the catalog with its live stock, pick a pool or a city and carrier, ask for a quote, then send the order with an Idempotency-Key. Payment comes from the account balance, and the answer carries the proxy lines.
We ran every read call below on 20 November 2026 with a normal API key. Answers are shortened with "..." where they are long; the catalog lists what is on sale at the moment you ask, and the totals by country and city are on the ISP proxies page.
Two ways to buy: ready pools and city plans
| Ready pool | City plan | |
|---|---|---|
| You choose | Country and site category | Country, city and, if you want, the carrier (ASN) |
| Catalog call | GET /public/premium-isp/pools | GET /public/premium-isp/cities |
| Length | 30 days | From 1 day to 3 months |
Both give dedicated static IPs with their own login, one line per IP. What each product is for is on the ISP proxies page; this post is about driving it from code.
Step 1: read the catalog and its stock
$ curl -s "https://api.quanticdata.io/v1/public/premium-isp/pools?country=US" -H "Authorization: Bearer $QD_API_KEY"
{"type":"response","message":"success","payload":{"enabled":true,"days":30,"currency":"USD", ...
"pools":[
{"id":"premium-us-retail","country":"US","category":"retail","name":"Premium United States Retail ISP",
"days":30,"minQuantity":1,"maxQuantity":200,"available":true,"subnet":false,"stock": ..., ...},
{"id":"premium-us-ticket","country":"US","category":"ticket", ... "available":true,"stock": ..., ...},
...]}}
Three fields decide whether an order will go through:
available: whether the pool can be bought right now.stock: the IPs on hand when the catalog was read.maxQuantity: the most one order can take. It is 200 at most and lower when a pool holds fewer IPs, so read it again before a large order.
City plans have their own catalog. It lists the plan lengths on sale with the price per IP for each, and every country and city with its stock:
$ curl -s "https://api.quanticdata.io/v1/public/premium-isp/cities?type=city&country=NL" -H "Authorization: Bearer $QD_API_KEY"
{"type":"response","message":"success","payload":{"enabled":true,"type":"city","maxAgeSeconds":120,
"lengths":[{"id":"1_day", ...},{"id":"7_days", ...},{"id":"1_month", ...},{"id":"2_months", ...},{"id":"3_months", ...}],
"countries":[{"name":"Netherlands", ... "cities":[{"location":"Netherlands - Amsterdam","name":"Amsterdam", ...}, ...]}]}}
Keep the location string exactly as written: it is the value the next calls take.
Step 2: pick a carrier (optional)
If the job needs one provider's network, ask which carriers have IPs in the city. The answer lists each carrier with its ASN and stock; the first entries for New York City that evening:
$ curl -s -G https://api.quanticdata.io/v1/public/premium-isp/cities/carriers \
--data-urlencode "location=United States - New York City" -H "Authorization: Bearer $QD_API_KEY"
{"type":"response","message":"success","payload":{"location":"United States - New York City","type":"city",
"carriers":[{"asn":54004,"name":"Cablevision Lightpath LLC","stock": ...},
{"asn":7922,"name":"Comcast Cable Communications, LLC","stock": ...},
{"asn":6079,"name":"RCN","stock": ...}, ...]}}
Pass one asn to the quote and the order to pin that carrier; leave it out for any carrier, which gives the most stock. A carrier fee per IP applies when you pin one, and the quote shows it. The product side of this choice is on city and carrier targeting.
Step 3: get a quote
The quote is the server-side price for an exact selection, with the VAT rate for a balance payment (0%) and whether your balance covers it. It is free and reserves nothing.
$ curl -s -X POST https://api.quanticdata.io/v1/public/premium-isp/quote \
-H "Authorization: Bearer $QD_API_KEY" -H "Content-Type: application/json" \
-d '{"product":"city","type":"city","length":"1_month","location":"Netherlands - Amsterdam","quantity":2}'
{"type":"response","message":"success","payload":{"product":"city","length":"1_month","days":30,
"location":"Netherlands - Amsterdam","city":"Amsterdam","country":"Netherlands","asn":null,"quantity":2,
"perIpPrice": ..., "subtotal": ..., "vatRate":0,"vat":0,"total": ..., "currency":"USD",
"paymentMethod":"BALANCE","sufficientBalance":true,"reserved":false,"quotedAt":"2026-11-20T18:18:30.893Z"}}
A pool quote is shorter: {"product":"pool","poolId":"premium-us-retail","quantity":5} answered with the same price fields. Prices are returned by the catalog and the quote in USD; the published per-IP prices for Standard ISP are on ISP proxy pricing.
What "currently unavailable" means
Stock moves all day: other customers buy, plans expire, new ranges arrive. A pool that cannot be bought at the moment is marked "available": false in the catalog, and a quote or an order for it answers 409:
{"type":"error","message":"This Premium ISP product is currently unavailable.","payload":{"code":"POOL_UNAVAILABLE"}}
Nothing is charged. The message describes that pool at that moment, not the product or your account. What a script should do:
- Read the catalog first and only quote pools with
available: trueand enoughstock. - Pick a neighbour. The same country usually has other categories on sale, and the city catalog lists every city with IPs on hand.
- Check again later, slowly. The catalog is cached for up to 2 minutes (
maxAgeSeconds: 120), so asking more often than that returns the same answer. A check every few minutes is plenty; quotes are capped at 300 an hour per account.
City plans work the same way: read the cities catalog and choose from what it lists.
Step 4: buy, with an Idempotency-Key
The order takes the same body as the quote, plus a header that makes it safe to send twice. The request below is the documented form of the order call.
curl -s -X POST https://api.quanticdata.io/v1/public/premium-isp/orders \
-H "Authorization: Bearer $QD_API_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: 5f0c2a9e-7d1b-4c3a-9e2f-1a2b3c4d5e6f" \
-d '{"product":"city","type":"city","length":"1_month","location":"Netherlands - Amsterdam","quantity":2,"maxTotal":TOTAL_FROM_QUOTE}'
| Answer | Meaning | What to do |
|---|---|---|
| 201 | Delivered | Read the lines with GET /public/premium-isp/orders/{orderId}?include=lines |
| 202 | Paid, IPs being prepared | Poll the order at the URL in the Location header |
200, replayed: true | This key was already used | Use the order in the answer; nothing was charged again |
| 402 | The balance does not cover the total | Top up in the dashboard, send the request again |
409 PRICE_CHANGED | The total is above your maxTotal | Quote again and decide |
Two habits make a buyer script dependable. Generate one Idempotency-Key per purchase (a UUID works) and reuse it on every retry of that purchase, so a timeout can never turn into two orders. And send maxTotal from the quote, so the order is refused if the price moved. Timing for every payment method is in how long delivery takes.
After delivery, POST /public/proxies/generate with the order id returns one line per dedicated IP. Renewal has its own quote and order calls, and city plans can swap an IP; all of it is in the API reference under Premium ISP. If an AI agent does the buying for you, start from QuanticData for AI agents. General advice on pacing API calls is in 429 Too Many Requests.


