Residential quickstart

This page takes you from a new account to a first request through an ipvolt residential proxy: buy a pack, find the connection details, send a request.

Buy a pack

Residential proxies are sold as prepaid packs of GB, paid from your balance. Create an account in the dashboard and add funds with crypto, as Billing and renewals describes. Then open the residential proxies page of the dashboard, select a pack under Choose a pack and confirm it.

A pack is a one-time purchase. Nothing renews on its own, and we set no expiry date on the GB you buy.

Find the connection details

When the pack is on your key, the same page shows Your key and Connection details:

• the host, res.ipvolt.com, with port 7000 for HTTP and 7001 for SOCKS5;
• a username, which you get by choosing a network and a country and selecting Get username;
• your key, which is the password.

Copy proxy URL copies the whole line, and Copy command copies a ready curl command.

Send a first request

Put the proxy URL in an environment variable so that the key stays out of your code and your shell history:

export PROXY_URL="http://USERNAME:KEY@res.ipvolt.com:7000"

USERNAME is the whole username from the dashboard, such as ACCOUNT-peer-us-iptype-residential, and KEY is your key. Then:

curl -sS -x "http://USERNAME:KEY@res.ipvolt.com:7000" https://api.ipify.org
curl -sS -x "socks5h://USERNAME:KEY@res.ipvolt.com:7001" https://api.ipify.org

import os
import requests

proxy = os.environ["PROXY_URL"]  # http://USERNAME:KEY@res.ipvolt.com:7000
response = requests.get("https://api.ipify.org", proxies={"http": proxy, "https": proxy}, timeout=30)
print(response.text)

The printed IP is the address the website sees. For a socks5h:// URL in Python, install requests[socks] first. Your key is sent unencrypted to the gateway, so connect from networks you trust and select Regenerate if the key is exposed.

Next steps

• Targeting and sessions: choose a country and keep or rotate the IP.
• Usage and billing: how GB are counted and what happens at zero.
• Code examples: the same proxy URL works in every example.