Documentation Python quickstart Blog Free tools Enterprise solutions hello@quanticdata.ioLog in

ISP proxy API: check stock, get a quote and buy static IPs from code

Buying ISP proxies through the API in four calls: read the catalog with live stock, pick a city and a carrier, get a quote, buy with an Idempotency-Key; the card lists what the catalog answer holds: ready pools by country and category, city plans by city and carrier, and the available, stock and maxQuantity fields of every entry.
Buying ISP proxies through the API in four calls: read the catalog with live stock, pick a city and a carrier, get a quote, buy with an Idempotency-Key; the card lists what the catalog answer holds: ready pools by country and category, city plans by city and carrier, and the available, stock and maxQuantity fields of every entry.

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 poolCity plan
You chooseCountry and site categoryCountry, city and, if you want, the carrier (ASN)
Catalog callGET /public/premium-isp/poolsGET /public/premium-isp/cities
Length30 daysFrom 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: true and enough stock.
  • 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}'
AnswerMeaningWhat to do
201DeliveredRead the lines with GET /public/premium-isp/orders/{orderId}?include=lines
202Paid, IPs being preparedPoll the order at the URL in the Location header
200, replayed: trueThis key was already usedUse the order in the answer; nothing was charged again
402The balance does not cover the totalTop up in the dashboard, send the request again
409 PRICE_CHANGEDThe total is above your maxTotalQuote 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.

Sources & further reading

FAQ

Quick answers on ISP proxy API.

Something else? Ask us

Can I buy ISP proxies through an API?

Yes. The Premium ISP endpoints list pools and cities with live stock, return a quote and take the order, paid from the account balance. The order needs an Idempotency-Key header.

What does "This Premium ISP product is currently unavailable" mean?

That pool has no IPs on sale at that moment. The answer is a 409 with the code POOL_UNAVAILABLE and nothing is charged. Read GET /public/premium-isp/pools and choose a pool with available: true, or check again in a few minutes.

How do I know how many IPs are in stock?

Every pool, country, city and carrier in the catalog carries a stock figure, and pools carry maxQuantity, the most one order can take. The catalog is cached for up to 2 minutes and the purchase checks stock again.

Can I choose the carrier of an ISP proxy by API?

Yes, on city plans. GET /public/premium-isp/cities/carriers lists the carriers of a city with their ASN and stock; pass one asn to the quote and the order.

How do I avoid paying twice if a request times out?

Send the same request again with the same Idempotency-Key. It answers 200 with replayed: true and the order it already created; the balance is charged once.

Does a quote reserve the IPs?

No. The quote answers with "reserved": false. The order reads stock and price again before it charges, which is why maxTotal is worth sending.

Static IPs your code can order

Premium ISP pools and city plans, with live stock in the catalog and a quote before every purchase.

Related reading