NewUnlimited residential proxies: unmetered traffic on a fixed price. From $33.25/day

Help center

Proxonym help center

60 answers about setup, billing, proxies and your account. Refunds, IP replacements and your data are requests in your dashboard.

Getting started7 answers

How do I get started with Proxonym?

Create an account, top up your balance with one of the five supported cryptocurrencies, then pick a product and plan in the dashboard and pay from your balance. Residential, mobile, unlimited residential, shared datacenter and SERP API plans are active at once, and ISP and dedicated IPs are delivered in under an hour.

Your proxy username and password then appear in the dashboard. The quick start walks you through your first request.

How do I send my first request through a proxy?

With an active residential plan, run this command with your own credentials:

curl -x http://gw.proxonym.com:8000 -U "USERNAME-country-de-session-a7k2:PASSWORD" https://api.ipify.org

The response is your exit IP: a residential IP in Germany that stays the same for 10 minutes, the default session lifetime. Remove -country-de for a random country, or remove -session-a7k2 to get a new IP on every request. Examples for other languages are in code examples.

Which proxy type should I choose?
  • Residential: well-protected sites, SERP tracking and city-level targeting, billed per GB.
  • Unlimited residential: large, steady crawls where per-GB billing adds up, billed by bandwidth speed.
  • Mobile: social platforms and mobile apps that trust carrier IPs.
  • ISP: accounts and long sessions that need a static residential IP.
  • Datacenter and dedicated: high-volume jobs on lightly protected targets, where speed and cost per IP matter most.
  • SERP API: Google results as parsed JSON, without running your own scraper.

Still unsure? Start with the smallest pack of the closest match and measure it on your own targets: a plan with minimal usage can be refunded within 3 days.

Can I test the network before buying a large plan?

Yes, start with a small order. The smallest packs are 5 GB of residential traffic for $9.95 and 2 GB of mobile traffic for $4.76. ISP proxies start at 5 IPs for $10.91 for 30 days, and dedicated datacenter proxies at 5 IPs for $6.65 per month.

If the service does not fit your use case, request a refund from My plans in the dashboard within 3 days of purchase. Orders with minimal usage, up to 1 GB on GB plans or negligible use on IP plans, are refunded under the refund policy.

Where do I find my proxy credentials?

Your proxy username and password are in the dashboard once a plan is active. Residential, mobile and unlimited residential plans use them on the gateway, with targeting options added to the username; see authentication.

ISP and dedicated proxies come as a list in the format ip:port:username:password, and shared datacenter proxies as an ip:port list. You can download lists from the dashboard or the account API.

Which tools and programming languages are supported?

Proxonym works with any client that supports HTTP or SOCKS5 proxies. Step-by-step guides cover curl, Python Requests, Scrapy, Node.js, Puppeteer, Playwright, Selenium, Go, PHP and Java, as well as the anti-detect browsers AdsPower and Multilogin.

Browse them on the integrations page.

How do I get help?

Proxonym does not take messages by e-mail. This help center and the documentation answer most questions, including what each error code means.

Everything else happens in your dashboard, under Support: request a plan refund, an unspent top-up refund or new static IPs, export your data or close your account. Accounts with an active dedicated datacenter plan can also open tickets with our team. See how support works.

Billing and payments8 answers

Which payment methods do you accept?

We accept five cryptocurrencies, and only these: Bitcoin, Ethereum, Monero, Tether USDT on the TRON network (TRC-20) and Solana. Send USDT on TRON only: USDT sent on Ethereum or another chain cannot be credited. Card, bank and PayPal payments are not available for self-serve plans.

You add funds to your account balance, then pay for plans from it. Prices are in US dollars. Every top-up, order and balance change is listed under Billing and exports to CSV.

How do top-ups and the bonus work?

Top up from $30 under Billing in the dashboard: pick an amount and a cryptocurrency, then send the exact amount shown to the address shown before the payment window closes. Your balance is credited automatically once the network confirms the transaction, usually within minutes.

Top-ups of $100 or more earn bonus credit: +5% for every full $100, up to +50% from $1,000. Your balance never expires. Bonus credit is promotional: it can be spent on any plan but cannot be withdrawn.

Do plans renew automatically?

No. Plans never auto-renew, so you are never charged without placing an order yourself. When a plan nears its end or your balance runs low, renew or top up from the dashboard whenever you choose.

How long do residential and mobile GB packs stay valid?

GB packs are one-time purchases with a validity of 30, 60 or 90 days, or no expiry, chosen at checkout. Longer validity costs a little more per GB, and the pricing page shows every option.

What happens when my traffic or plan runs out?

The gateway returns 402 when your traffic balance is used up or your plan has expired, and requests work again once you top up or renew. Track consumption in the dashboard or with GET /usage on the account API so a job does not stop unexpectedly.

How quickly is my order activated?

Residential, mobile, unlimited residential, shared datacenter and SERP API plans are active the moment you pay from your balance. ISP and dedicated datacenter IPs are delivered in under an hour. Top-ups are credited once your transaction is confirmed on the network.

You can follow each order under My plans: its IPs appear there as soon as they are delivered.

Can I get a refund?

Request it from your dashboard within 3 days of purchase: open My plans, then Request a refund in the menu next to the plan. Eligible orders with minimal usage are refunded to your balance: up to 1 GB used on GB plans, or negligible use on IP plans. Unspent top-ups can be sent back in the cryptocurrency you paid with within 14 days, without the bonus credit: use Refund next to the top-up under Billing.

You follow each request, and read our answer, under Support. The full conditions are in the refund policy.

Are there volume discounts?

Yes, unit prices fall as orders grow. Residential and mobile traffic goes down to $0.74/GB at 10 TB, ISP proxies to $1.15 per IP at 5,000 IPs for 30 days, shared datacenter to $0.013 per IP at 40,000 IPs and dedicated datacenter to $0.70 per IP at 1,000 IPs.

Beyond the largest tier, you can hold several plans at once; see Proxonym for teams.

Residential and mobile7 answers

How large is the residential network?

The residential network has 55M+ IPs in 195+ countries. The largest pools are in the United States (8.3M), Brazil (5.2M), India (3.2M), the United Kingdom (2.3M) and Mexico (1.8M).

Browse coverage by country on the locations page.

How do I target a country, state, city or ASN?

Add parameters to your username, separated by dashes: USERNAME-country-us for a country, USERNAME-country-us-state-california for a state, USERNAME-country-us-city-new_york for a city or USERNAME-asn-7922 for a network such as Comcast.

Country codes are lowercase ISO 3166-1 alpha-2, and place names are lowercase with underscores for spaces, such as sao_paulo. Use a state or a city, not both, and leave out the country to get a random one. See geo-targeting.

How do rotating and sticky sessions work?

Without a session parameter, the gateway gives every request a new IP. Add -session-a7k2, with an ID of 1 to 32 letters or digits, to keep the same IP, and -lifetime-30 to set how many minutes it lasts: 1 to 120 on residential, with a 10-minute default.

The IP is chosen when a connection opens, so a client that reuses a keep-alive connection keeps its IP until that connection closes. See rotating and sticky sessions.

Why did my sticky IP change before the lifetime ended?

Residential IPs belong to real devices, and a session cannot outlast the device behind it. If that device disconnects, the session cannot keep its IP, and you may see a 502 that you can retry.

Design multi-step tasks to tolerate an occasional IP change, for example by checking login state, and keep lifetimes as short as the task allows.

Which countries do mobile proxies cover?

Mobile proxies use 3G, 4G and 5G carrier IPs in the United States, United Kingdom and Austria, with more countries rolling out. Add -type-mobile and a country to your username, for example USERNAME-country-gb-type-mobile.

Mobile IPs rotate per connection. For a sticky mobile IP, add -session-{id} with a lifetime of up to 3 minutes, from -lifetime-1 to -lifetime-3. See mobile proxies.

Do residential and mobile traffic share one balance?

Yes. Mobile traffic is sold in the same GB packs as residential and draws from the same balance, so one top-up covers both. Requests with -type-mobile use carrier IPs, and all other requests use residential IPs.

Which protocols do residential and mobile proxies support?

HTTP and HTTPS on gw.proxonym.com:8000, and SOCKS5 on gw.proxonym.com:1080, with the same username parameters on both ports. With SOCKS5, use remote DNS resolution (socks5h:// in most tools) so the proxy resolves hostnames.

See protocols for details.

ISP and datacenter8 answers

What is the difference between ISP and datacenter proxies?

ISP proxies are static IPs registered to consumer internet providers, so sites see a residential network, while the IPs run at datacenter speed. Datacenter IPs belong to hosting providers: they cost less and are fast, but strict sites recognize them more easily.

Use ISP proxies for accounts and long sessions, and datacenter proxies for volume on lightly protected targets.

Which locations are available for ISP proxies?

ISP proxies are available in 17 locations: New York, Los Angeles, Virginia, a Comcast pool and a Verizon pool in the United States, plus Canada, Germany, the United Kingdom, Hong Kong, Japan, France, Italy, Poland, Spain, Singapore, Moldova and South Korea.

The Comcast and Verizon pools and South Korea are priced slightly higher.

How do I connect to ISP and dedicated proxies?

Once your IPs are delivered, download the list from the dashboard or with GET /proxies/isp or GET /proxies/dedicated on the account API, in text or JSON. Each line uses the format ip:port:username:password, and HTTP and SOCKS5 both work on the listed port.

On ISP proxies, SOCKS5 carries both TCP and UDP. See proxy lists.

How do shared datacenter proxies authenticate?

Shared datacenter IPs accept a username and password or IP whitelisting, with 3 whitelisted IPs included. Download your ip:port list from the dashboard or with GET /proxies/datacenter; each IP serves HTTP on port 3129 and SOCKS5 on port 1081.

A request from an address that is not whitelisted and without valid credentials returns 407.

Do datacenter proxies rotate?

Not by default. Shared datacenter plans give you a static list of IPs, and you decide how to spread requests across them, for example round-robin in your scraper.

Dedicated datacenter IPs stay reserved to your account for the whole plan, and you can request replacements.

Is bandwidth limited on ISP and datacenter plans?

ISP and dedicated datacenter proxies include unlimited bandwidth. Shared datacenter plans pair an IP pack with a monthly bandwidth tier of 250 GB, 1 TB, 5 TB or Unlimited, and the Unlimited tier is subject to fair use.

See limits and fair use.

Can I replace a dedicated IP that gets blocked?

Yes. Dedicated datacenter IPs come with replacements on request: open My plans, choose Replace IPs in the menu next to the plan and list the IPs with the reason.

Dedicated IPs are available in 8 countries: the United States, Canada, Germany, France, Italy, Japan, India and Taiwan.

Which terms can I buy ISP and datacenter proxies for?

ISP proxies are sold per IP for 1, 7, 30 or 90 days, starting at 5 IPs for $10.91 for 30 days. Shared datacenter plans are monthly, from $17.50 for 1,000 IPs with 250 GB, and dedicated datacenter IPs are billed per IP per month, from $6.65 for 5 IPs.

Unlimited residential8 answers

How is unlimited residential billed?

By bandwidth speed instead of traffic volume: 100, 200, 400, 600 or 800 Mbps or 1 Gbps, for 1, 7 or 30 days. Traffic is not metered in GB, so the price stays fixed however much data you move within your speed and the fair use rules.

Plans start at $133 for 100 Mbps for one day, and a 30-day 100 Mbps plan costs $997.50, or $33.25 per day.

How do I pick the right speed?

The plan speed caps your total throughput, so size it for your peak load rather than your total volume. At full sustained use, 100 Mbps moves roughly 1 TB per day.

A 1-day plan is a practical way to measure your real throughput before you commit to 7 or 30 days.

Which gateway should I connect to?

You choose a dedicated gateway server at checkout: de.unl.proxonym.com (Germany), use.unl.proxonym.com (US East) or usw.unl.proxonym.com (US West). Connect on port 8000 for HTTP or 1080 for SOCKS5, with the same username parameters as residential proxies.

Pick the gateway closest to your servers to keep latency low. See unlimited residential.

How long can a sticky session last?

Up to 12 hours. Add -session-{id} and -lifetime-{minutes} with a value from 1 to 720, for example USERNAME-country-us-session-a7k2-lifetime-720. Without a session parameter, every request gets a new IP.

What does the UDP add-on do?

Selected at checkout, the UDP add-on enables UDP traffic over SOCKS5 on port 1080 of your unlimited gateway. Use it for protocols that run over UDP, such as QUIC or DNS.

Without the add-on, unlimited plans carry TCP traffic over HTTP and SOCKS5.

Is there a limit on threads or connections?

No. Unlimited residential includes unlimited concurrency, so you can run as many parallel sessions as your bandwidth supports. Usage must follow fair use under the acceptable use policy, and the per-account burst limit of around 10,000 requests per second still applies.

How many IPs and countries does unlimited residential cover?

About 10M residential IPs in 180+ countries, targeted with the same username parameters as the main residential network. That is a smaller pool than the 55M+ IPs and 195+ countries of per-GB residential, so test your key countries on a 1-day plan before you buy a long term.

When should I choose unlimited instead of per-GB residential?

Choose unlimited for large, steady volumes such as continuous crawls, media-heavy pages or AI training data, where per-GB costs keep climbing. Per-GB residential suits smaller or irregular workloads, the widest country coverage and sticky sessions of up to 120 minutes.

Read unlimited residential proxies explained for how the model works.

Technical8 answers

Which hosts and ports do I connect to?
  • Residential and mobile: gw.proxonym.com, port 8000 for HTTP/HTTPS and 1080 for SOCKS5.
  • Unlimited residential: de.unl.proxonym.com, use.unl.proxonym.com or usw.unl.proxonym.com, port 8000 for HTTP and 1080 for SOCKS5.
  • Shared datacenter: the IPs in your list, port 3129 for HTTP and 1081 for SOCKS5.
  • ISP and dedicated: your ip:port:username:password list, with HTTP and SOCKS5 on the same port.

See endpoints and ports.

What does a 407 error mean?

407 Proxy Authentication Required means the gateway rejected your credentials or, on whitelisted access, your request came from an IP that is not on your whitelist.

Copy the username and password again from the dashboard, check that targeting parameters are joined with dashes, and URL-encode special characters when credentials sit inside a proxy URL. See authentication.

What do the other gateway error codes mean?
  • 402: your traffic balance is used up or your plan has expired; top up or renew.
  • 403: the target is blocked under the acceptable use policy.
  • 429: the request rate guard was triggered; slow down and retry with backoff.
  • 502: the upstream peer failed; retry the request.
  • 504: the target did not respond within 60 seconds; retry later or check the target.

See errors and troubleshooting.

Why does my IP stay the same between requests?

The gateway assigns an IP when a connection opens. Most HTTP clients and browsers keep connections alive and reuse them, so consecutive requests to the same site go through the same tunnel and exit IP.

For a new IP per request, open a new connection each time, for example by disabling keep-alive or creating a new client, and make sure the username has no -session- parameter.

Do you support SOCKS5 and UDP?

Yes. SOCKS5 is available on port 1080 of the residential and unlimited gateways, on port 1081 of shared datacenter IPs and on the listed port of ISP and dedicated IPs.

UDP over SOCKS5 is supported on ISP proxies, shared datacenter proxies and unlimited residential plans with the UDP add-on. See protocols.

How do I use the account API?

Send requests to https://api.proxonym.com/v1 with the header Authorization: Bearer <API_KEY>. The API returns JSON, allows 60 requests per minute and covers your account, usage, proxy lists, whitelist and sub-users:

curl -H "Authorization: Bearer $API_KEY" https://api.proxonym.com/v1/account

See the API reference for every endpoint.

What uptime and limits should I plan for?

The network targets 99.9% uptime, and every product allows unlimited concurrent sessions. Each account has a burst limit of around 10,000 requests per second, and the gateway's request rate guard answers 429 when traffic needs to slow down.

The account API is limited separately to 60 requests per minute. See limits and fair use.

How can I check that my proxy works?

Request https://api.ipify.org through the proxy and compare the result with your own IP, or test it with the proxy checker.

Code samples are in code examples and the integration guides.

Account and security7 answers

How do I create sub-users?

Create sub-users in the dashboard or with POST /sub-users, sending a name and a traffic_limit_gb. Each sub-user gets its own proxy credentials and traffic limit, which keeps teams, clients or projects separate.

Change a limit with PATCH /sub-users/{id} and remove access with DELETE /sub-users/{id}. See the API reference.

How do I whitelist an IP address?

Add your server's public IP in the dashboard or with POST /whitelist and an ip value. List entries with GET /whitelist and remove one with DELETE /whitelist/{ip}.

Shared datacenter plans include 3 whitelisted IPs. A request from an address that is not whitelisted and carries no valid credentials returns 407.

Where do I find my API key?

Your API key is in the dashboard. Send it as Authorization: Bearer <API_KEY> to the account API; the SERP API reads its key from the X-API-Key header instead.

See the API reference for examples.

How should I store proxy credentials and API keys?

Keep them in environment variables or a secrets manager, not in source code or client-side scripts. Give each team or tool its own sub-user so you can revoke one set of credentials without disrupting the others.

If credentials or a key may have leaked, act right away from the dashboard: generate a new proxy password under Proxies, reset the sub-user's password, revoke the API key and sign out other sessions under Settings.

Why would you ask me to verify my identity?

We ask for verification (KYC) only for sensitive use cases or when usage patterns look unusual. It protects legitimate customers and the people who share their connections with the network.

Standard use of the network does not require it.

How do you handle my personal data?

We process personal data in line with GDPR principles. The privacy policy explains what we collect, why we collect it and how to exercise your rights.

Can my whole team use one account?

Yes. Create a sub-user for each person, team or client, so everyone has separate proxy credentials and a traffic limit that keeps one project from draining the shared balance.

Deleting a sub-user cuts off only its own credentials.

Policies7 answers

What is not allowed on the Proxonym network?

The acceptable use policy prohibits illegal activity and abuse, such as fraud, spam or attacks on other networks. We block abusive targets, and requests to them return 403.

Using a proxy does not change what the law or a website's terms allow.

Why does a specific website return 403?

If the 403 comes from the gateway, the target is blocked under our acceptable use policy. For HTTPS targets, this shows up as a refused CONNECT before any page content arrives. Customers with an active dedicated datacenter plan who have a legitimate need can ask about verification in a ticket.

A 403 inside a normal page response comes from the website itself, which refused the request; try a different proxy type, slower pacing or more realistic headers.

How do I report abuse from a Proxonym IP?

Report it to the network that operates the IP address, through the abuse contact listed in its WHOIS record, with the timestamps and time zone, the affected URLs or services and any relevant logs. On our side, high-risk targets are blocked at the gateway, and suspicious activity is investigated and acted on under our acceptable use policy.

Where do your residential IPs come from?

From people who opted in through partner apps and SDKs. They are informed about how their connection is used and can opt out.

To protect them, we block abusive targets and require verification for sensitive use cases. Read more on the ethics page.

What does fair use mean on unlimited plans?

Unlimited residential plans and the Unlimited bandwidth tier on shared datacenter proxies are not metered by GB, but they are subject to fair use under the acceptable use policy. The policy describes what counts as abusive or excessive traffic, so that capacity stays reliable for every customer.

Which documents govern my use of Proxonym?

The terms of service, the acceptable use policy, the refund policy and the privacy policy together govern your account and plans.

Read them before you buy: each one opens with a short summary in plain language.