Endpoints and protocols

What the host, HTTP port, SOCKS5 port and outgoing IP mean, how to choose between HTTP and SOCKS5, and why to use socks5h.

All docs pages

Each mobile proxy is its own endpoint: a host and two ports that belong to your device, not a shared gateway name. This page explains each field and how to choose between HTTP and SOCKS5.

What the dashboard shows

FieldWhat it is
HostThe address your client connects to.
HTTP portAccepts HTTP proxy requests, including CONNECT tunnels for https:// websites.
SOCKS5 portAccepts SOCKS5 connections with a username and password.
Username and passwordThe device's proxy credentials.
Outgoing IPThe carrier IP websites see. It changes when the device rotates.

Some devices list the HTTP and SOCKS5 endpoints separately, each with its own host and login.

HTTP or SOCKS5

HTTP portSOCKS5 port
Proxy URLhttp://USERNAME:PASSWORD@HOST:HTTP_PORTsocks5h://USERNAME:PASSWORD@HOST:SOCKS5_PORT
https:// websitesTunnelled with CONNECTTunnelled
Errors from the proxyHTTP status codes such as 407 or 502SOCKS replies or a closed connection
Browsers with a loginPlaywright and PuppeteerChromium does not send SOCKS credentials
Librariescurl, Requests, HTTPX, aiohttp, Node.js, Scrapy, Gocurl; Requests and HTTPX with their SOCKS extras

Start with the HTTP port unless your tool only speaks SOCKS5. HTTP vs SOCKS5 proxies compares the two in more detail.

Use socks5h for SOCKS5

With socks5h:// the proxy resolves the website's hostname, so the DNS lookup also leaves from the mobile network. With socks5:// most clients resolve the name on your machine first and send only the IP address, which exposes the lookup to your own resolver. socks5 vs socks5h shows the difference across six clients.

Check the connection

Request an IP echo service through the proxy and compare the result with the outgoing IP in your dashboard:

sh
curl -sS -x "http://USERNAME:PASSWORD@HOST:HTTP_PORT" https://api.ipify.org

Common mistakes

  • An https:// proxy URL on the HTTP port makes the client start TLS with the proxy, which fails with SSL: WRONG_VERSION_NUMBER. Use http:// for the proxy. See SSL WRONG_VERSION_NUMBER behind a proxy.
  • An HTTP client pointed at the SOCKS5 port gets no status at all, for example curl: (56) Proxy CONNECT aborted. Check the port. See Tunnel connection failed: 502.
  • A leftover HTTPS_PROXY or NO_PROXY variable can send traffic somewhere else or around the proxy. See Proxy environment variables.

Plug in your first proxy.

Mobile from $9 a day. Residential from $2.40 per GB, opening soon.