Docs

Connect in minutes

Our proxies work with any tool that supports authenticated HTTP proxies. Here's everything you need to get started.

Quick start

  1. 1Create an account — you'll get a 16-digit account number. Save it; it's your only login.
  2. 2Top up your balance with USDT, BTC, LTC or ETH.
  3. 3Buy a traffic package. Traffic is added to your proxy account automatically.
  4. 4Open the proxy generator in your dashboard, choose a location and session type, and copy your credentials.

Credentials format

The generator gives you a gateway host, port, username and password. You can copy them in the common host:port:user:pass format or as a proxy URL. Your proxy password is separate from your account number and can be regenerated at any time from the dashboard.

format
HOST:PORT:USERNAME:PASSWORD

In the examples below, replace HOST, PORT, USERNAME and PASSWORD with the values from your dashboard.

curl

terminal
curl -x "http://USERNAME:PASSWORD@HOST:PORT" https://api.ipify.org?format=json

Python

Using the popular requests library:

example.py
import requests

proxy = "http://USERNAME:PASSWORD@HOST:PORT"
proxies = {"http": proxy, "https": proxy}

r = requests.get("https://api.ipify.org?format=json", proxies=proxies, timeout=30)
print(r.json())  # {"ip": "<residential IP>"}

Node.js

Using undici, the HTTP client that powers fetch in Node.js:

example.mjs
// npm install undici
import { fetch, ProxyAgent } from "undici";

const agent = new ProxyAgent("http://USERNAME:PASSWORD@HOST:PORT");

const res = await fetch("https://api.ipify.org?format=json", { dispatcher: agent });
console.log(await res.json()); // { ip: "<residential IP>" }

Sessions & targeting

Location (country, and city where available) and session type are encoded in the proxy username. You don't need to build it by hand — the generator in your dashboard produces the exact string to use.

  • Rotating — a new residential IP for every request. Best for large-scale data collection.
  • Sticky — keeps the same IP for a period of time. Best for multi-step flows that expect one visitor.

Traffic & billing

Every byte sent and received through the proxy counts toward your traffic package. Your dashboard shows purchased, used and remaining traffic. Prices are per GB; you can buy additional packages at any time from your balance.