Documentation

Quickstart

1. Create an account and top up from 1 GB.
2. Pick a product and location in the dashboard.
3. Plug the gateway into your tool.

The first request takes under a minute.

curl -x gate.chronoproxy.com:7000 -U "USER:PASS" https://api.ipify.org

Authentication

Two methods: login and password on every request, or an IP whitelist managed in the dashboard. With a whitelist you can omit credentials entirely. Rotate the password from the dashboard at any time; old credentials stop working within 60 seconds.

Endpoints & ports

[Replace with the real gateway hosts and ports.]

Targeting

Append targeting keys to the username. Keys can be combined; unknown keys are ignored.

USER-country-us
USER-country-us-state-ny
USER-country-us-city-newyork
USER-country-de-asn-3320

Country codes are ISO 3166-1 alpha-2. City names are lowercase with spaces removed.

Sessions & rotation

By default every request exits from a new IP. To keep an IP, add a session key; the session lives for up to 6 hours of activity.

USER-country-gb-session-abc123
USER-country-gb-session-abc123-sessionduration-30   # minutes

Protocols

HTTP, HTTPS (CONNECT) and SOCKS5 with UDP association on residential and mobile. ISP and datacenter proxies additionally support p0f OS profile switching from the dashboard.

Code examples

import requests
proxy = "http://USER-country-us:[email protected]:7000"
r = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=15)
print(r.text)

import { HttpsProxyAgent } from "https-proxy-agent";
const agent = new HttpsProxyAgent("http://USER-country-us:[email protected]:7000");
const res = await fetch("https://api.ipify.org", { agent });
console.log(await res.text());

curl -x gate.chronoproxy.com:7000 -U "USER-country-us-city-newyork:PASS" https://api.ipify.org

Limits & fair use

Unlimited concurrent threads on all plans. Per-IP products have a fair-use policy against abuse. Accessing resources prohibited by law or by our terms is blocked at the gateway.

Errors