LIVE NETWORK

API REFERENCE

Routes across the Proxiat proxy network

United Statesmonitored

Germanymonitored

Rotate + Ultraonline

API Reference

Introduction

Use the Proxiat API to list stock, buy proxies, and manage rotate mobile proxies from your own system.

Base URL: https://api.proxiat.com/api/v1

Create your API token and webhook from the API button in the Proxiat Telegram bot. The token is shown once.

Do not add a trailing slash to paths. /proxies/services/rotate-mobile-proxy/ is not valid.

Authentication

Every request must include your token as a Bearer header.

Authorization string required

Format: Bearer pxt_.... An invalid token returns 401. A revoked token returns 403.

Usage limits

Limits are applied per API token, per minute.

Group	Limit	Used by
`read`	120 / minute	GET endpoints
`write`	10 / minute	POST endpoints
`default`	60 / minute	Fallback

Errors

Errors use a consistent JSON body. Validation failures on /api/v1 are returned as 400, not 422.

Status	error	When
400	`invalid_request`	Missing or invalid field
400	`insufficient_balance`	Not enough balance
400	`unsupported_operation`	Operation is not available for this service
401	`invalid_token`	Token is missing or unknown
403	`token_inactive`	Token is revoked or inactive
404	`order_not_found` / `service_not_found` / `proxy_not_found`	Resource does not exist
409	`proxy_already_bought` / `port_unavailable` / `username_taken`	Conflict
429	`rate_limited`	Too many requests
502	`purchase_failed` / `operation_failed`	Upstream failure

Webhooks

If a webhook is active for proxy.expired, expiry is delivered to your URL instead of Telegram. If delivery fails, Proxiat falls back to Telegram.

Create the webhook in the bot. The signing secret is shown once and starts with whsec_.

X-Proxiat-Timestampstringrequired

Unix timestamp used in the signature. Reject the request if it is older than 2 minutes.

X-Proxiat-Signaturestringrequired

sha256=<hex> of HMAC-SHA256(secret, "{timestamp}.{raw_body}").

Get account

Return the user id, token status, and current balance.

GET/api/v1/me

List services

Return public catalog keys and plan prices. final_price already includes any discount.

GET/api/v1/proxies/services

Get stock

List available Ultra SOCKS proxies or rotate mobile servers. Use ultra-socks or rotate-mobile-proxy.

GET/api/v1/proxies/services/{service_key}

service_keystringrequired

Path parameter. ultra-socks returns proxies. rotate-mobile-proxy returns servers.

countrystringoptional

Filter by country name or code.

statestringoptional

Filter by state.

ispstringoptional

Filter by ISP.

Buy Ultra SOCKS

Purchase one Ultra SOCKS proxy from stock. Send an empty body. Price is taken from the catalog, not from the client.

POST/api/v1/proxies/services/ultra-socks/{proxy_id}

proxy_idintegerrequired

Encrypted Proxiat listing id from stock. This is not the PremSocks id.

Buy rotate mobile proxy

Create a rotate mobile proxy. Location and price come from stock and plans. Do not send country, ISP, or price.

POST/api/v1/proxies/services/rotate-mobile-proxy

server_namestringrequired

Server name from stock.

portintegerrequired

Port from that server.

protocolstringrequired

http or socks5.

duration_hoursintegerrequired

A duration allowed on this port.

auth_methodstringrequired

user_pass or ip.

usernamestringoptional

Required when auth_method is user_pass.

passwordstringoptional

Required when auth_method is user_pass.

auth_ipstringoptional

Required when auth_method is ip.

List proxies

Return proxies you already own. Owned operations below work only for rotate-mobile-proxy.

GET/api/v1/proxies

service_keystringoptional

Filter by ultra-socks or rotate-mobile-proxy.

order_idstringoptional

Return one owned order.

limitintegeroptional

1–200. Default 200.

Extend

Add time to an active rotate mobile proxy.

POST/api/v1/proxies/{order_id}/extend

order_idstringrequired

Owned rotate order id.

duration_hoursintegerrequired

Hours to add. Must be an allowed plan for this port.

Renew

Renew an expired rotate mobile proxy. Returns a new order_id.

POST/api/v1/proxies/{order_id}/renew

order_idstringrequired

Expired rotate order id.

duration_hoursintegerrequired

Plan duration for the new order.

Change location

Move an active rotate mobile proxy to another server and port.

POST/api/v1/proxies/{order_id}/location

server_namestringrequired

Target server from stock.

portintegerrequired

Target port on that server.

Change protocol

Switch an active rotate mobile proxy between HTTP and SOCKS5.

POST/api/v1/proxies/{order_id}/protocol

protocolstringrequired

http or socks5.

Change auth

Update username, password, or auth IP. Send only the fields you want to change.

POST/api/v1/proxies/{order_id}/auth

usernamestringoptional

New username.

passwordstringoptional

New password.

auth_ipstringoptional

New authentication IP.

Change auth method

Switch an active rotate mobile proxy between user/password and IP authentication.

POST/api/v1/proxies/{order_id}/auth-method

auth_methodstringrequired

user_pass or ip.

usernamestringoptional

Required when switching to user_pass.

passwordstringoptional

Required when switching to user_pass.

auth_ipstringoptional

Required when switching to ip.