Quickstart

This proxy quickstart shows you how to set up a proxy with ColdProxy and send your first authenticated request in a few minutes. It walks you from ordering a plan to building a proxy connection string and confirming your exit IP. Each step links to the relevant reference page if you want a deeper look at the underlying proxy server setup.

#Step 1 — Choose and order a plan

Pick the proxy type that matches your workflow (the full comparison is in Choosing a product), then complete checkout on the pricing page.

Free trials may be available after individual review; ask through our contact channels. Eligible plans also support short paid validation windows; hourly buying is available on Residential IPv4 (Unmetered) and Residential IPv6 so you can test before committing to a longer billing period.

#Step 2 — Find your credentials and gateway host

Open your plan in the client area. You will find:

• Gateway host — gw-{service-id}.coldproxy.com, where {service-id} is the numeric service/package ID for this plan. Code examples on this page use gw-2312.coldproxy.com.
• Port range — any port from 30000 to 34999. Use 30000 to start.
• Username and password — used for User:Pass authentication on every request.

#Step 3 — Build your proxy string

A ColdProxy connection string is four colon-separated fields:

host : port : username : password

Using your gateway host, port 30000, and your credentials:

gw-2312.coldproxy.com:30000:USERNAME:PASSWORD

Most HTTP clients also accept the URL form:

http://USERNAME:PASSWORD@gw-2312.coldproxy.com:30000

#Step 4 — Make your first proxied request

cURL

curl -x "http://USERNAME:PASSWORD@gw-2312.coldproxy.com:30000" \
  "https://api.vipv6proxy.com/api/checker/my-ip"

Python (requests)

import requests

proxy = "http://USERNAME:PASSWORD@gw-2312.coldproxy.com:30000"
proxies = {"http": proxy, "https": proxy}

resp = requests.get("https://api.vipv6proxy.com/api/checker/my-ip", proxies=proxies, timeout=30)
print(resp.json())

If the response returns an IP address that is not your own machine's IP, your connection is working.

#Step 5 — Verify your exit IP and location

Use the free ColdProxy tools to confirm the exit IP, country, and protocol reachability:

• My IP — visit this page through your proxy to see the exit IP, country, and network it came from.
• Proxy Checker — paste your proxy string to check IPv4 and IPv6 reachability, exit IP, and detected location.

For IPv6 plans, also run a request through https://api6.vipv6proxy.com/api/checker/my-ip to confirm the IPv6 exit address.

#Next steps

• How to connect — gateway host, port range, and proxy-string anatomy in detail.
• Authentication — User:Pass vs IP whitelisting, and how to use both together.
• Protocols — HTTP, HTTPS, and SOCKS5 on the same gateway.
• Ports & SuperPorts — pin geo and session settings to port ranges.