Start here · Quickstart

From an empty account to a request that exits where you chose.

Five steps, no SDK to install, any HTTP client. Ten minutes if you already hold some crypto.

4 min read 2 sections Updated Sep 21, 2026

The five steps#

01
Create an account and fund the wallet
Sign up with an email address, then top up from $20 in any listed coin (BTC, ETH, USDT, USDC, LTC, XMR, SOL, TRX, DOGE). The balance is credited when the transaction confirms on its network, usually within minutes, and it never expires.
02
Copy your gateway credentials
The dashboard shows one username and one password for the shared gateways (residential and mobile). Dedicated ISP, datacenter and mobile-device orders come with their own ip:port:user:pass lines instead.
03
Pick the endpoint for the job
Shared networks are one hostname each; you choose the location from the username, not from the hostname. Dedicated products are their own ip:port.
Network Endpoint HTTP(S) SOCKS5
Residential res.hodlproxy.com 9000 9001
Mobile, rotating mob.hodlproxy.com 9000 9001
ISP, datacenter, mobile device the IP from your list 8000 8001

Network	Endpoint	HTTP(S)	SOCKS5
Residential	res.hodlproxy.com	9000	9001
Mobile, rotating	mob.hodlproxy.com	9000	9001
ISP, datacenter, mobile device	the IP from your list	8000	8001

Send the first request

The example asks an IP-echo service what address it sees. -cc-us in the username asks for a United States exit; run it twice and you get two different households.

cURL

curl -x http://USER-cc-us:[email protected]:9000 https://api.ipify.org

Python

import requests

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

Node.js

import { fetch, ProxyAgent } from "undici";

const dispatcher = new ProxyAgent("http://USER-cc-us:[email protected]:9000");
const res = await fetch("https://api.ipify.org", { dispatcher });
console.log(await res.text());

PHP

$ch = curl_init("https://api.ipify.org");
curl_setopt_array($ch, [
    CURLOPT_PROXY          => "http://res.hodlproxy.com:9000",
    CURLOPT_PROXYUSERPWD   => "USER-cc-us:PASS",
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);

proxyURL, _ := url.Parse("http://USER-cc-us:[email protected]:9000")
client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}}
resp, err := client.Get("https://api.ipify.org")

05
Target more precisely and hold an IP
Everything is a -key-value pair appended to the username: -city-berlin inside -cc-de for one city, -sid-a1b2c3 to keep the same IP across requests, -ttl-30m to say for how long. The Targeting & sessions page lists every parameter.
cURL
```
# One Berlin household, held for 30 minutes across requests
curl -x http://USER-cc-de-city-berlin-sid-a1b2c3-ttl-30m:[email protected]:9000 \
     https://api.ipify.org
```

Where to go next#

AuthenticationUsername-password or IP whitelist, and how parameters travel with each.Targeting & sessionsCountry, state, city, ASN, sticky sessions and their lifetime.Code examplesPython, Node.js, PHP, Go, Java, C#, Playwright, Puppeteer, Scrapy and more.Errors & troubleshootingWhat each status code from the gateway means and what to change.

Proxies

Menu

From an empty account to a request that exits where you chose.

The five steps#

Create an account and fund the wallet

Copy your gateway credentials

Pick the endpoint for the job

Send the first request

Target more precisely and hold an IP

Where to go next#

Paste the endpoint, watch the exit change.