proxy_check
Test a proxy URL before binding it to an identity, returning exit IP, country, and latency or a clear error so dead or slow exits are caught early.
Instructions
Test a proxy URL and report where it actually comes out. No identity needed.
Use it before binding a proxy to an identity with profile_create: a dead or slow exit found here costs nothing, the same exit found halfway through a signup costs the account.
Args: url: the proxy URL to test, e.g. "http://user:pass@host:port" or "socks5://host:port".
Returns {ok: true, exit_ip, country, latency_ms} when the proxy works, or
{ok: false, error} when it does not. A dead proxy is an ANSWER, not a
failure — check the ok field rather than assuming success. Note that
country can be null even on a working proxy if the exit IP cannot be
geolocated.
This tests a bare URL. To test the proxy an identity is already bound to, the daemon's per-identity check is a separate endpoint not yet exposed here.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes |