# Residential quickstart

Source: https://ipvolt.com/docs/residential-quickstart
Markdown: https://ipvolt.com/docs/residential-quickstart.md

[Home](https://ipvolt.com/index.md) / [Docs](https://ipvolt.com/docs.md) / [Residential quickstart](https://ipvolt.com/docs/residential-quickstart.md)

Section: Residential proxies
Updated: 2026-11-11
Author: ipvolt

Buy a prepaid residential pack, find the host, username and key in the dashboard, and send a first request over HTTP or SOCKS5.

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](https://ipvolt.com/dashboard) and add funds with crypto, as [Billing and renewals](/docs/billing) describes. Then open the residential proxies page of the dashboard, select a pack under **Choose a pack** and confirm it.

| Prepaid pack | Price | Per GB |
| --- | --- | --- |
| 1 GB | $2.20 | $2.20 |
| 5 GB | $11 | $2.20 |
| 25 GB | $55 | $2.20 |
| 50 GB | $110 | $2.20 |
| 100 GB | $220 | $2.20 |
| 250 GB | $550 | $2.20 |

Every pack costs the same $2.20 per GB. 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:

```sh
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:

```sh
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
```

```python
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](/docs/residential-sessions): choose a country and keep or rotate the IP.
- [Usage and billing](/docs/residential-usage): how GB are counted and what happens at zero.
- [Code examples](/docs/code-examples): the same proxy URL works in every example.

## More documentation

- Previous: [Locations and carriers](https://ipvolt.com/docs/locations.md)
- Next: [Targeting and sessions](https://ipvolt.com/docs/residential-sessions.md)
- [All documentation](https://ipvolt.com/docs.md)