Authenticate with email + password and cache an encrypted token at ~/.coronium/token.enc. Most other tools auto-login when CORONIUM_LOGIN/CORONIUM_PASSWORD are set in the env, so calling this manually is only needed for explicit re-auth or account switching.

Verify the cached token is still valid. Returns true/false. Useful before a long agentic session — if invalid, call coronium_login or rely on auto-login.

Clear the cached token from ~/.coronium/token.enc. Subsequent calls will require re-authentication (manual or auto-login).

Get account profile (email, role, contact, business data) and overall balance summary.

Get the customer's spendable balance. Shows account_credit (USD wallet — what's actually used to pay for proxies) plus any held crypto balances valued in USD. Crypto prices cached 60s; not shown per row.

List crypto deposit addresses + balances (BTC, USDT, etc). Use these addresses to top up — incoming transfers convert to account_credit at deposit time. Account_credit itself is excluded; use coronium_get_balance for that.

List saved credit cards on file (Stripe). Returns last-4 digits + brand only.

Get the configured low-balance email alert tiers (USD amounts). When account_credit drops below a tier, an alert email is sent. Endpoint shipped 2026-04-30.

Set low-balance email alert tiers. The backend currently allows exactly these tier values: 100, 300, 500 (USD). Pass any subset — e.g. [100], [100,300], [100,300,500]. Email is sent when account_credit dips below each tier independently.

Get the full payment + invoice ledger for the account (for reconciliation / spotting duplicates or overpayments). Differs from coronium_get_payment_status, which checks a single payment.

Get the account's modem-lifecycle webhook URL (fires when a dead modem is auto-swapped). null = disabled (notifications via email).

Set or clear the modem-lifecycle webhook. When set, a dead modem is auto-swapped and your HTTPS endpoint receives a JSON POST with old_modem_id + new_modem_id. Pass null/empty to disable.

List the user's mobile proxies. Returns one line per proxy with name, host:port, login, expiry, country.

Get full details for a single proxy by id or name. Includes credentials, expiry, external IP, rotation interval.

Trigger a rotation (new IP) on the customer's modem via authenticated /v3 endpoint. Idempotent in-flight: if a rotation is already pending, returns its status. Use coronium_get_rotation_status to poll.

Poll rotation status for a modem. Returns idle | rotating | success | failed plus the current and previous external IPs. Backend stuck-rotation janitor (deployed 2026-04-30) auto-clears stale 'rotating' states within 5 min.

Token-based rotation via the public reset service (default https://mreset.xyz). Doesn't require an API token — uses the per-modem rotation token embedded in the proxy record. Optionally polls until completion.

Test connectivity through a proxy. Sends a request through the modem's HTTP/SOCKS endpoint and returns the observed external IP plus latency.

Swap a broken/dead modem for a working one of the same country/tariff. Used when a modem has consecutive ping failures or won't rotate. Subscription transfers — you keep the same expiry. Requires existing-customer auth.

Configure auto-rotation cadence (in seconds). 0 disables auto-rotate. Typical values: 60 (1 min), 300 (5 min), 1800 (30 min). Backend Rotator service polls and triggers per this interval.

Rotate the HTTP/SOCKS proxy password. Generates a new random password server-side and returns it.

Set a free-form metadata note on a modem (e.g. 'production-fb-account-X'). Visible only to the owner; useful for tagging proxies in agent workflows.

Set the p0f OS fingerprint preset (Android / iOS / Windows / etc) the modem should advertise. Useful when the destination platform fingerprints clients.

Cancel a modem subscription (no further auto-renew). The modem remains usable until its current tariff_expired_at. Refund policy applies per terms.

Get the OpenVPN config blob for a modem. Some modems offer VPN tunnel access in addition to HTTP/SOCKS proxy; this returns the .ovpn content.

Liveness/health snapshot for all your proxies (per-modem reachability + recommendation). Call this before retrying through a proxy — stop hammering dead modems; swap them with coronium_replace_modem.

List the valid OS fingerprint (p0f) values accepted by coronium_set_modem_os for a modem. Call this first so you don't guess the OS string.

Re-apply / re-push a modem's port settings on the server (useful after a config change or if a proxy stops responding but the modem is online).

List countries that have stock available. Returns ISO-2 + display name + count of free modems.

List available tariffs (price plans). Each entry has duration, price, supported countries, included GB. Use coronium_check_coupon before buying for coupon validation.

List free (purchasable) modems available right now. Useful before buying — confirms the country/tariff combination has live stock.

Validate a coupon code. Returns the discount %, fixed-amount, or error if invalid/expired.

Buy one or more modems using account_credit (USD wallet balance). Specify a tariff_id and quantity. Optionally include a coupon. Modems are auto-assigned from free stock matching the tariff's country pool.

Renew one or more existing modems for an additional tariff period using account_credit.

Check the status of a payment by id. Useful after coronium_buy_modems_with_balance / coronium_renew_modems_with_balance to confirm settlement.

List the customer's support tickets. Returns id, subject, status, last update.

Get full ticket detail including all replies.

Open a new support ticket.

Add a reply to an existing ticket.

Archive a ticket (closes it from the customer side).

Pool Gateway (pay-per-GB): live pool stock availability. Returns 503 if the pool tier is not enabled on this deployment.

List my pay-per-GB pool keys (status, traffic remaining, tariff). Use coronium_build_pool_proxy_url to get a usable proxy URL for an active key.

Build a usable proxy URL (or URLs) for an active pool key. Returns host gw.proxies.sx + credentials. Optional protocol (http|socks5), count, and country targeting.

Top up (add traffic/credit to) an existing pool key.

Cancel a pool key.

Buy a pay-per-GB pool key using account balance. Pass a pool tariff_id (from coronium_list_tariffs; pool tariffs have a traffic cap).

List my currently-open sticky pool sessions.

Close a pool session. Pass session_key to close one, or omit it to close ALL of my pool sessions.