# ISP Proxy API: Stock, Quote and Buy by Code

> Buy ISP proxies through an API: list pools and cities with live stock, pick a carrier, quote, then purchase with an Idempotency-Key. Real calls and answers.

[Home](https://quanticdata.io/) / [Blog](https://quanticdata.io/blog/) / ISP Proxy API: Stock, Quote and Buy by Code

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

Proxies · Nov 20, 2026 · 5 min read · By [Aldo Morese](https://quanticdata.io/about/), founder of QuanticData

![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.](https://quanticdata.io/blog/isp-proxy-api/hero.webp?v=20261120h)

On this page

- [Two ways to buy: ready pools and city plans](https://quanticdata.io/blog/isp-proxy-api/#two-ways-to-buy-ready-pools-and-city-plans)
- [Step 1: read the catalog and its stock](https://quanticdata.io/blog/isp-proxy-api/#step-1-read-the-catalog-and-its-stock)
- [Step 2: pick a carrier (optional)](https://quanticdata.io/blog/isp-proxy-api/#step-2-pick-a-carrier-optional)
- [Step 3: get a quote](https://quanticdata.io/blog/isp-proxy-api/#step-3-get-a-quote)
- [What "currently unavailable" means](https://quanticdata.io/blog/isp-proxy-api/#what-currently-unavailable-means)
- [Step 4: buy, with an Idempotency-Key](https://quanticdata.io/blog/isp-proxy-api/#step-4-buy-with-an-idempotency-key)

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.

**Run it on the free credit.** Every QuanticData account gets $2 of free API usage per month.

[Start free — $2/month included](https://quanticdata.io/signup/?utm_source=blog&utm_medium=website&utm_campaign=blog-lead&utm_content=isp-proxy-api) · [Explore ISP Proxies from $2.50/IP in 61 Countries](https://quanticdata.io/isp-proxies/)

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](https://quanticdata.io/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](https://quanticdata.io/isp-proxies/) page; this post is about driving it from code.

## Step 1: read the catalog and its stock

```bash
$ 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:

```bash
$ 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:

```bash
$ 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](https://quanticdata.io/isp-proxies/city-carrier-targeting/).

**Try it on your own targets.** Every QuanticData account gets $2 of free API usage per month.

[Start free — $2/month included](https://quanticdata.io/signup/?utm_source=blog&utm_medium=website&utm_campaign=blog-inline&utm_content=isp-proxy-api) · [Explore ISP Proxies from $2.50/IP in 61 Countries](https://quanticdata.io/isp-proxies/)

## 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.

```bash
$ 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](https://quanticdata.io/isp-proxies/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:

```json
{"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.

```bash
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](https://quanticdata.io/blog/how-long-to-get-proxies-after-payment/).

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](https://quanticdata.io/docs/) under Premium ISP. If an AI agent does the buying for you, start from [QuanticData for AI agents](https://quanticdata.io/for-agents/). General advice on pacing API calls is in [429 Too Many Requests](https://quanticdata.io/blog/429-too-many-requests-web-scraping/).

### Sources & further reading

- [IETF draft: The Idempotency-Key HTTP Header Field](https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/)
- [RFC 9110: 409 Conflict](https://www.rfc-editor.org/rfc/rfc9110#status.409)
- [IANA: Autonomous System (AS) Numbers](https://www.iana.org/assignments/as-numbers/as-numbers.xhtml)

## FAQ

Quick answers on ISP proxy API.

[Something else? Ask us](mailto:hello@quanticdata.io)

### 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.

[Start free — $2/month included](https://quanticdata.io/signup/?utm_source=blog&utm_medium=website&utm_campaign=blog-end&utm_content=isp-proxy-api) · [Explore ISP Proxies from $2.50/IP in 61 Countries](https://quanticdata.io/isp-proxies/)

## Related reading

- [Forward Proxy vs Reverse Proxy, Both Run Live](https://quanticdata.io/blog/forward-proxy-vs-reverse-proxy/): Proxies · A forward proxy sits in front of clients and makes requests for them; a reverse proxy sits in front of servers and receives requests for them. We ran one of each on 20 November 2026, a mobile proxy line and a 26-line Node.js reverse proxy, and printed what the client and the server saw.
- [HTTP vs HTTPS: What a Proxy Sees in Each](https://quanticdata.io/blog/http-vs-https-proxy/): Proxies · HTTP sends requests as plain text; HTTPS wraps the same requests in TLS. We put a logging relay in front of a residential proxy line on 20 November 2026 and captured both: 340 readable bytes for http://, and for https:// one CONNECT line followed by 803 encrypted bytes.
- [Change Proxy IP by Link: Rotation Links](https://quanticdata.io/blog/change-proxy-ip-by-link/): Proxies · A rotation link is a URL that restarts one sticky session: open it and the session starts again; in our test of 20 November 2026 each of three calls was followed by a new exit IP. Below: the API call that creates the link, what it answered, the 10-second pause between rotations, and what to do on Mobile and Residential Premium.

---

Source: https://quanticdata.io/blog/isp-proxy-api/ · Site index for AI: https://quanticdata.io/llms.txt
