SotaProxy

Buy and manage proxies (residential, ISP, IPv4/IPv6, mobile) from AI agents in plain language.

От сообществаРаботаетНужен API-ключГлобальныйБесплатноТолько чтение

Что умеет

Get Balance: Get the prepaid account balance (USD). All purchases draw from this balance — check it before buying and tell the user to top up in the dashboard if it is insufficient.
List Products: List sellable proxy products. ipv4/ipv6/isp are period-based (pick a country id and period id from this response, then quote_order). residential is traffic-based (see residential_plans)
Quote Order: Price an ipv4/ipv6/isp order WITHOUT buying. ALWAYS call this before buy_proxies and show the user the exact total for confirmation. IPv6 minimum quantity is 10.

Какие данные видит

Нужен ли аккаунт

Нужен API-ключ из настроек сервиса

Buy and manage proxies (residential, ISP, IPv4/IPv6, mobile) from AI agents in plain language. Prepaid balance, quote-before-charge, 19 tools. Universal residential GEO login: switch country/city per request via login suffixes.

Список инструментов сервера (19)

Технические названия из tools/list. Нужны только разработчикам.

get_balance	Get the prepaid account balance (USD). All purchases draw from this balance — check it before buying and tell the user to top up in the dashboard if it is insufficient.
list_products	List sellable proxy products. ipv4/ipv6/isp are period-based (pick a country id and period id from this response, then quote_order). residential is traffic-based (see residential_plans). mobile is tariff-based (see mobile_tariffs). Country ids are PER PRODUCT — never reuse an ipv4 country id for isp.
quote_order	Price an ipv4/ipv6/isp order WITHOUT buying. ALWAYS call this before buy_proxies and show the user the exact total for confirmation. IPv6 minimum quantity is 10.
buy_proxies	Buy ipv4/ipv6/isp proxies, charging the prepaid balance. Call quote_order first and get explicit user confirmation of the total before calling this. Proxies may take a few minutes to provision — poll get_order_proxies afterwards. Note: IPv6 serves ONE protocol chosen here via `protocol` (HTTPS default or SOCKS5) — only the matching port is issued.
list_orders	List the account's orders, newest first.
get_order_proxies	Get the issued proxies (ip, ports, login, password) for an order. Empty right after purchase means still provisioning — retry in a minute. Set format="txt" for plain ip:port:login:password lines.
list_proxies	List all active proxies on the account (ipv4/ipv6/isp/mobile). Residential endpoints are separate — use list_residential_endpoints.
quote_renewal	Price a renewal WITHOUT charging. IMPORTANT: renewal is order-level — renewing one proxy renews EVERY proxy bought in the same order, and the price covers all of them. Always show the user proxiesRenewed and price before renew_order.
renew_order	Renew a proxy's ENTIRE order (all proxies bought together), charging the balance. Call quote_renewal first and get explicit user confirmation.
residential_plans	List residential traffic packages (GB) with this account's pricing. Residential is traffic-based: buy a GB package, then create endpoints with geo targeting inside it.
residential_locations	Geo catalog for residential targeting. Without arguments: all countries (code + name). With country code (e.g. "AT"): regions, cities and ISPs for that country.
buy_residential_package	Buy a residential GB package, charging the balance. Check residential_plans for the exact total and get explicit user confirmation first. After buying, create an endpoint with create_residential_endpoint to get usable credentials.
residential_packages	List the account's residential packages with remaining traffic.
create_residential_endpoint	Create a proxy endpoint inside a residential package — THIS is where geo targeting is set. Returns ready-to-use credentials (host:port + login:password). rotation: 0 = new IP per request, -1 = sticky session, 1-3600 = seconds between rotations.
residential_universal_access	Get the package's UNIVERSAL geo login: one stable login/password where targeting is appended as login suffixes per request — `login_c_US`, `login_c_US_city_New-York`, sticky sessions via `_s_{id}_ttl_{30s\|15m\|1h}`. Prefer this over create_residential_endpoint when the user needs many locations or per-request geo switching: no endpoint creation, no port limits. Requires an active residential package.
list_residential_endpoints	List the account's residential endpoints with their credentials.
delete_residential_endpoint	Delete a residential endpoint (its credentials stop working). Confirm with the user first.
mobile_tariffs	List mobile proxy tariffs (country + carrier + rental period + unit price + stock). Filter with a country code, e.g. "DE". Check stock before buying.
buy_mobile_proxies	Buy mobile proxies from a tariff, charging the balance. Show the user unitPrice × quantity from mobile_tariffs and get explicit confirmation first. Credentials appear via get_order_proxies.