Returns all proxies owned by the authenticated user with full connection details (host, port, login, password, geo, operator, expiration). Use this first when the user asks anything about "my proxies", to find a specific proxy, or to get a proxy_id needed for other tools. Supports filtering by type (mobile/server/backconnect/residential) and id_country (numeric ID — use get_country_list to resolve from ISO codes; that tool lands in v0.2). The server already drops expired proxies, but active_only rechecks client-side as a safety net.

Returns the CURRENT external IP of a proxy and optionally checks if that IP is listed in spam/abuse blacklists (Spamhaus, Stop Forum Spam, etc). Use to verify a fresh rotation succeeded, or to decide if you need to rotate again because the IP is dirty. The check_spam=true mode is slower (~3s extra) but is the only way to assess IP quality.

Returns the current account balance: main funds in RUB plus the optional can_payout amount for accounts with partner status. Use this BEFORE buy_proxy to confirm the user has enough funds — buy_proxy will fail silently-ish with "Insufficient balance" otherwise.

Returns all geo-locations (geoid + human caption + ISO + free-modem count) where proxies are currently available for purchase or migration. Use this to: recommend a location to the user, validate before buy_proxy or change_geo, or filter by country (set country to a 2-letter ISO code). The geoid value is needed for buy_proxy. Cached server-side for 60s and client-side for 5 minutes.

Returns the price quote for proxies in a given country across all available durations (1, 3, 7, 14, 30, 60, 90, 180, 365 days). Use this to inform the user about cost BEFORE buy_proxy. The country argument accepts a 2-letter ISO code (e.g. "RU") OR a numeric id_country.

Forces the mobile proxy to acquire a new IP address from the carrier (changes the cellular session). This is THE core mobile-proxy feature — agents use it between scraping requests, account creations, etc. Takes ~3-10 seconds and returns the new IP. Costs nothing — IP rotation is included in the subscription. Set verify=true to auto-check the new IP after rotation (adds ~1-2s). Only works on mobile proxies (proxy_type=0) — they are the only ones with a proxy_key.

Swaps the underlying modem of a proxy to one in a different country and/or with a different mobile operator, WITHOUT buying a new proxy (the same proxy_id keeps its login/password — only the physical location changes). Pass at least one of: country (ISO code), id_country (numeric), geoid (from get_geo_list — most specific), or operator (name). Use check_after_change=true to have the server verify the new IP is live before returning (adds 1-10s). Subject to a per-proxy cooldown.

Purchases one or more new mobile proxies and adds them to the account. Charges the balance IMMEDIATELY — REQUIRES explicit user confirmation. Always call get_balance + get_price first, and ideally do a dry-run with estimate_only=true to see the final amount. country accepts ISO code or numeric id_country; for geo-precise orders pass geoid from get_geo_list. period_days must be one of 1,3,7,14,30,60,90,180,365. Returns the new proxies with full connection details on success.