This guide shows you how to buy new proxies through the API, from scratch — check what's available, calculate the price, place the order and fetch the purchased IPs.

Every request uses your personal API key from your account dashboard (how to get your API key). In the examples below, replace YOUR_API_KEY with your own key. To pay from your account balance, use paymentId = 1.

⚠️ The order step charges your balance. Always check the cost with the calculation step first.

The flow at a glance

Check your balance.
Look up what can be ordered (country, period).
Pick a payment method (or use your balance).
Calculate the price.
Place the order.
Fetch the purchased proxies.

Step 1 — Check your balance

Make sure you have enough balance for the purchase.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get

Response

{
  "status": "success",
  "data": { "summ": 10 },
  "errors": []
}

Step 2 — Look up what can be ordered

The Reference List returns everything you need to place an order: countries, periods, targets, carriers and rotations (for mobile). Copy the countryId and periodId you need.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}

Path parameters

Name	Value	Description
type	`ipv4`	The proxy type (ipv4, ipv6, mobile, isp, mix, mix_isp).

Example

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4

Response

{
  "status": "success",
  "data": {
    "items": [
      {
        "country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
        "period":  [ { "id": "1m", "name": "1 month" } ]
      }
    ]
  },
  "errors": []
}

Step 3 — Choose a payment method

List the available payment systems and copy the id you want as paymentId. To pay from your account balance, simply use paymentId = 1.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list

Response

{
  "status": "success",
  "data": {
    "items": [
      { "id": "30", "name": "Visa / MasterCard" },
      { "id": "41", "name": "USDT (TRC-20)" },
      { "id": "29", "name": "PayPal" },
      { "id": "35", "name": "Binance" }
    ]
  },
  "errors": []
}

Step 4 — Calculate the price

Calculate the order price before buying. Volume and rental-period discounts are applied just like on the website. This step does not charge anything.

The body fields depend on the proxy type. The common fields are below; for IPv6 also pass protocol, for mobile operatorId + rotationId, for residential use tarifId — all from the Reference List.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Request body

Name	Type	Description
countryId	Number	ID of the country from the Reference List (Step 2).
periodId	String	ID of the rental period from the Reference List.
quantity	Number	The number of proxies to order.
paymentId	Number	Payment system ID. `1` = balance, `43` = card added to your account.
coupon (optional)	String	A coupon code, if you have one.
authorization (optional)	String	Authorization method. Leave blank to use login:password.
customTargetName (optional)	String	A custom goal/target name, if needed.

Example

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc

Response — shows the total, your balance, the discount and the per-proxy price:

{
  "status": "success",
  "data": {
    "warning": "",
    "balance": 2000,
    "total": 9,
    "quantity": 5,
    "currency": "USD",
    "discount": 0.45,
    "price": 1.8
  },
  "errors": []
}

Step 5 — Place the order (charges your balance)

When the calculated price looks right, place the order. This step charges your balance. Use the same parameters as in Step 4. From the response copy the orderId.

Endpoint

POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Request body

Name	Type	Description
countryId	Number	ID of the country from the Reference List (Step 2).
periodId	String	ID of the rental period from the Reference List.
quantity	Number	The number of proxies to order.
paymentId	Number	Payment system ID. `1` = balance, `43` = card added to your account.
coupon (optional)	String	A coupon code, if you have one.
authorization (optional)	String	Authorization method. Leave blank to use login:password.
generateAuth (optional)	String	Y/N — create custom authorization (default N).

Example

https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make

Response — returns the new order ID and your updated balance:

{
  "status": "success",
  "data": {
    "orderId": 2426273,
    "total": 16.2,
    "listBaseOrderNumbers": [ "3388485_57471911" ],
    "balance": 1776.88
  },
  "errors": []
}

Step 6 — Fetch the purchased proxies

Fetch the purchased proxies. Filter by the orderId from the previous step to see exactly what was bought.

Endpoint

GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}

Response

{
  "status": "success",
  "data": {
    "items": [
      {
        "id": "0678564",
        "order_id": "123456",
        "ip": "31.6.33.97",
        "protocol": "HTTP",
        "port_http": 12345,
        "port_socks": 12345,
        "login": "ruht5734hg",
        "password": "gou5h437g",
        "country": "Belgium",
        "country_alpha3": "BEL",
        "status_type": "ACTIVE",
        "date_start": "23.06.2024",
        "date_end": "23.07.2024"
      }
    ]
  },
  "errors": []
}