Este guia mostra como comprar novos proxies pela API do zero — verificar a disponibilidade, calcular o preço, fazer o pedido e obter os IPs comprados.
Cada requisição usa sua chave de API pessoal do painel da sua conta (como obter sua chave de API). Nos exemplos abaixo, substitua YOUR_API_KEY pela sua própria chave. Para pagar com o saldo da conta, use paymentId = 1.
⚠️ A etapa do pedido debita do seu saldo. Sempre verifique o custo primeiro na etapa de cálculo.
O fluxo em resumo
Verifique seu saldo.
Veja o que pode ser pedido (país, período).
Escolha um método de pagamento (ou use seu saldo).
Calcule o preço.
Faça o pedido.
Obtenha os proxies comprados.
Passo 1 — Verifique seu saldo
Verifique se você tem saldo suficiente para a compra.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/get
Resposta
{
"status": "success",
"data": { "summ": 10 },
"errors": []
}
Passo 2 — Veja o que pode ser pedido
A Reference List retorna tudo o que você precisa para fazer um pedido: países, períodos, alvos, operadoras e rotações (para mobile). Copie o countryId e o periodId necessários.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/{type}
Parâmetros de caminho
Nome | Valor | Descrição |
type |
| O tipo de proxy (ipv4, ipv6, mobile, isp, mix, mix_isp). |
Exemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/reference/list/ipv4
Resposta
{
"status": "success",
"data": {
"items": [
{
"country": [ { "id": 561, "name": "France", "alpha3": "FRA" } ],
"period": [ { "id": "1m", "name": "1 month" } ]
}
]
},
"errors": []
}
Passo 3 — Escolha um método de pagamento
Liste os sistemas de pagamento disponíveis e copie o id desejado como paymentId. Para pagar com o saldo, use simplesmente paymentId = 1.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/balance/payments/list
Resposta
{
"status": "success",
"data": {
"items": [
{ "id": "30", "name": "Visa / MasterCard" },
{ "id": "41", "name": "USDT (TRC-20)" },
{ "id": "29", "name": "PayPal" },
{ "id": "35", "name": "Binance" }
]
},
"errors": []
}
Passo 4 — Calcule o preço
Calcule o preço do pedido antes de comprar. Descontos por volume e período de aluguel são aplicados como no site. Esta etapa não cobra nada.
Os campos do corpo dependem do tipo de proxy. Os campos comuns estão abaixo; para IPv6 envie também protocol, para mobile operatorId + rotationId, para residencial use tarifId — tudo da Reference List.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Corpo da requisição
Nome | Tipo | Descrição |
countryId | Number | ID do país da Reference List (passo 2). |
periodId | String | ID do período de aluguel da Reference List. |
quantity | Number | O número de proxies a pedir. |
paymentId | Number | ID do sistema de pagamento. |
coupon (opcional) | String | Um código de cupom, se você tiver. |
authorization (opcional) | String | Método de autorização. Deixe em branco para usar login:senha. |
customTargetName (opcional) | String | Um nome de alvo personalizado, se necessário. |
Exemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/calc
Resposta — 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": []
}
Passo 5 — Faça o pedido (debita do seu saldo)
Quando o preço calculado estiver certo, faça o pedido. Esta etapa debita do seu saldo. Use os mesmos parâmetros do passo 4. Copie o orderId da resposta.
Endpoint
POST https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Corpo da requisição
Nome | Tipo | Descrição |
countryId | Number | ID do país da Reference List (passo 2). |
periodId | String | ID do período de aluguel da Reference List. |
quantity | Number | O número de proxies a pedir. |
paymentId | Number | ID do sistema de pagamento. |
coupon (opcional) | String | Um código de cupom, se você tiver. |
authorization (opcional) | String | Método de autorização. Deixe em branco para usar login:senha. |
generateAuth (opcional) | String | Y/N — criar autorização personalizada (padrão N). |
Exemplo
https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/order/make
Resposta — returns the new order ID and your updated balance:
{
"status": "success",
"data": {
"orderId": 2426273,
"total": 16.2,
"listBaseOrderNumbers": [ "3388485_57471911" ],
"balance": 1776.88
},
"errors": []
}
Passo 6 — Obtenha os proxies comprados
Obtenha os proxies comprados. Filtre pelo orderId da etapa anterior para ver exatamente o que foi comprado.
Endpoint
GET https://proxy-seller.com/personal/api/v1/YOUR_API_KEY/proxy/list/{type}
Resposta
{
"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": []
}
Referência completa da API
Order actions — lista de referência, cálculo e pedido
Retrieve active proxy — liste seus proxies
Balance — saldo e sistemas de pagamento