Getting Started
Buy a real 4G/5G mobile proxy in under 2 minutes. Account creation, depositing, purchasing, and connecting.
1. Create an account
Go to proxysmart.market/auth/buyer and enter your email. We send a one-click magic link — no password required. You can set one later in your profile.
New users are auto-registered. Your first magic link creates the account and signs you in — no separate registration step.
2. Add balance
Navigate to Dashboard → Balance → Deposit. Two payment methods:
- Stripe — credit/debit card (Visa, Mastercard, Amex). Instant credit. Min $5.
- CoinGate — cryptocurrency (BTC, ETH, USDT, and 70+ others). Credited on 1 confirmation. Min $5.
3. Browse and buy a proxy
Go to Dashboard → Buy Proxies. Proxies are grouped by country. Select a modem and choose a duration:
| Duration | Typical price | Best for |
|---|
| 1 hour | $0.33 | Quick tasks, testing |
| 24 hours | $2.50 | Day-long campaigns |
| 7 days | $8.40 | Week-long projects |
| 30 days | $30.00 | Long-running bots |
One proxy per modem. Each purchase allocates a dedicated physical modem. No shared IPs during your active order.
4. Receive credentials
After checkout, credentials are provisioned instantly (under 5 seconds). Go to Dashboard → My Proxies:
Host: 168.x.x.x
HTTP port: 8015
SOCKS5 port: 5015
Username: your_username
Password: your_password
Both HTTP and SOCKS5 are provided on every order at no extra charge.
5. Connect
curl
curl -x http://user:pass@host:8015 https://ipinfo.io/json
Python
import requests
proxies = {
"http": "http://user:pass@host:8015",
"https": "http://user:pass@host:8015",
}
r = requests.get("https://ipinfo.io/json", proxies=proxies)
print(r.json())
SOCKS5
import socks, socket
socks.set_default_proxy(socks.SOCKS5, "host", 5015, username="user", password="pass")
socket.socket = socks.socksocket
6. Rotate your IP
Click Rotate IP in the dashboard or call POST /api/orders/:id/rotate. The modem disconnects and reconnects to the carrier, acquiring a new IP. Average: 5–30 seconds depending on carrier.
IP rotation drops connections. Any active TCP connections will break. Rotate between tasks, not during requests.
7. Extend or cancel
- Extend — adds time to the same proxy (same credentials, same port). No reconnection.
- Cancel — releases the modem. Pending orders are fully refunded. Active orders are not refunded — remaining time is forfeited.
Proxy Types & Mobile Networks
CGNAT, carrier IP pools, and why mobile proxies work differently from datacenter or residential proxies.
What makes a mobile proxy
A mobile proxy routes traffic through a real SIM card on a live carrier network. The outbound IP is the carrier's public-facing IP — the same IP millions of legitimate mobile users share. This is why mobile proxies achieve near-zero block rates.
On ProxySmart, each proxy is a dedicated modem with a single SIM. One buyer, one modem — no shared IPs during an active order.
CGNAT — Carrier-Grade NAT
Under CGNAT, the carrier adds a NAT layer between subscriber and internet. A single public IPv4 is shared by hundreds to thousands of devices. When a website sees your IP, blocking it would block thousands of legitimate users — which is why mobile IPs are almost never blocked.
When you rotate (modem reconnects), the CGNAT gateway assigns a different IP from the carrier pool. Assignment is pseudo-random and pooled per region.
HTTP vs SOCKS5 vs OpenVPN
| Feature | HTTP | SOCKS5 | OpenVPN |
|---|
| Protocols | HTTP, HTTPS | TCP, UDP, QUIC | All (full tunnel) |
| Port range | 8001–8999 | 5001–5999 | 1194 UDP |
| Browser | Native | Extension/system | System-wide |
| UDP/QUIC | No | Yes | Yes |
| Full device | No | No | Yes |
| Availability | All servers | All servers | Almost all |
Use SOCKS5 for QUIC/HTTP3 and UDP workloads. Use OpenVPN for full-device routing. Use HTTP for browsers, curl, and tools with native proxy support.
Carrier profiles
| Carrier | ASN | Rotation speed | Best for |
|---|
| T-Mobile USA | AS21928 | 8–20s | US Google/YouTube, social media |
| AT&T Mobility | AS20057 | 10–25s | US banking/finance, e-commerce |
| Vodafone UK | AS25135 | 12–25s | UK retail, financial platforms |
| Three UK | AS13037 | 5–12s | High-frequency rotation, sneaker bots |
| Free Mobile FR | AS51207 | 10–20s | French-targeted tasks, EU geo |
Native carrier DNS
All ProxySmart proxies resolve DNS using the carrier's own resolvers — not Google or Cloudflare. Some anti-bot systems check DNS resolver consistency with IP carrier. A T-Mobile IP using T-Mobile DNS is undetectable.
IP Rotation
Force the modem to reconnect to the carrier and get a fresh IP. Same proxy, same credentials — only the outbound IP changes.
How it works
- Modem drops its data session (PDP context) — current IP is released.
- Modem reconnects — carrier assigns a fresh IP from the CGNAT pool.
- ProxySmart confirms the new IP before returning success.
What stays the same: host, port, username, password, country, carrier, and expiry. Only the outbound IP changes.
Methods
Dashboard: click Rotate IP. API:
POST /api/orders/:id/rotate
Authorization: Bearer <token>
→ { "ok": true, "message": "Rotation initiated. New IP in ~10–20s." }
# Or unauthenticated (order UUID is the secret):
GET /api/orders/:id/rotate
Timing by carrier
| Carrier | Typical time |
|---|
| Three UK | 5–12 seconds |
| T-Mobile USA | 8–20 seconds |
| Free Mobile FR | 10–20 seconds |
| AT&T Mobility | 10–25 seconds |
| Vodafone UK | 12–25 seconds |
Best practices
- Rotate between tasks — finish your request, then rotate.
- Don't over-rotate — every few minutes looks natural; every 30 seconds looks like a bot.
- Rotate after blocks — if a site blocks you, rotate and continue.
REST API Reference
Base URL: https://proxysmart.market/api. Auth via Authorization: Bearer <token>.
Authentication
POST /auth/register { email, password, role? } → { token }
POST /auth/login { email, password, role? } → { token } or { requiresTwoFactor, tempToken }
POST /auth/magic-link { email, role? } → { ok }
GET /auth/magic-link/verify?token=... → { token }
POST /auth/forgot-password { email } → { ok }
GET /auth/me 🔒 → { id, email, role, balance, shopName, status }
PATCH /auth/me 🔒 { shopName? } → { ok, user }
GET /auth/has-password 🔒 → { hasPassword }
POST /auth/set-password 🔒 { password } → { ok }
POST /auth/change-password 🔒 { currentPassword, newPassword } → { ok }
POST /auth/logout 🔒 → { ok }
Two-Factor Authentication (TOTP)
GET /auth/2fa/status 🔒 → { enabled }
POST /auth/2fa/setup 🔒 → { secret, otpauthUrl, qrDataUrl }
POST /auth/2fa/enable 🔒 { code } → { ok, backupCodes[] }
POST /auth/2fa/disable 🔒 { code } → { ok }
POST /auth/2fa/verify { tempToken, code } → { token }
Public (no auth)
GET /public/listings?limit=100 → { listings[], total }
GET /public/stats → { online, available, active_orders, countries, prices: { min, max, avg } }
Orders
GET /orders 🔒 ?status=active&page=1&limit=50 → { orders[], total, page, pages }
POST /orders 🔒 { modemId, duration, couponCode? } → { order }
GET /orders/:id 🔒 → { order } (credentials included for active orders)
POST /orders/:id/extend 🔒 { duration, couponCode? } → { ok, expiresAt }
POST /orders/:id/rotate 🔒 → { ok, message }
GET /orders/:id/rotate → { ok, message } (unauthenticated — UUID is secret)
GET /orders/:id/proxy-status 🔒 → { online, extIp, operator, networkType, signalStrength }
GET /orders/:id/vpn 🔒 → .ovpn file download (application/octet-stream)
DELETE /orders/:id 🔒 → { ok, refunded } (no refund for buyer-cancelled active orders)
Durations: 1h, 24h, 7d, 30d. Rotate cooldown: 65 seconds between rotations.
Balance & Payments
GET /balance 🔒 → { balance, transactions[] }
GET /balance/transactions 🔒 → { transactions[] } (last 100)
GET /balance/transactions/export 🔒 → CSV download
POST /balance/deposit/stripe 🔒 { amount: 5–5000 } → { url } (redirect to Stripe Checkout)
POST /balance/deposit/coingate 🔒 { amount: 5–5000, receiveCurrency? } → { url, orderId }
Servers & Modems (Farmer)
GET /servers 🌾 → { servers[] }
POST /servers 🌾 { name, apiUrl, integrationMode?, shopUsername?, ... } → { server }
GET /servers/:id 🌾 → { server }
PATCH /servers/:id 🌾 { name?, apiUrl?, ... } → { ok }
DELETE /servers/:id 🌾 → { ok }
POST /servers/:id/sync 🌾 → { ok, message: "Sync queued" }
POST /servers/:id/test-connection 🌾 → { ok, results[], psVersion, supportsMultishop }
PATCH /servers/:id/pause 🌾 → { ok } (emergency: unlist all modems)
PATCH /servers/:id/resume 🌾 → { ok }
GET /servers/:id/modems 🌾 → { modems[] }
GET /servers/:id/modems/:modemId 🌾 → { modem }
PATCH /servers/:id/modems/:modemId 🌾 { action: 'list'|'unlist'|'maintenance'|'notes' } → { ok }
POST /servers/:id/modems/bulk 🌾 { modemIds[], action } → { ok, affected, skipped }
POST /servers/:id/modems/bulk-price 🌾 { prices: { 1h, 24h, 7d, 30d }, modemIds? } → { ok, affected }
PATCH /servers/:serverId/modems/:modemId/plans 🌾 { 1h, 24h, 7d, 30d } → { ok }
GET /servers/:id/modems/:modemId/ping 🌾 → { modemId, online, extIp, operator, networkType, ... }
GET /servers/:id/earnings 🌾 → { earnings: { allTime, last30d, last7d, last24h }, modems[] }
GET /servers/:id/reports/modem-timeline 🌾 ?days=30 → { modems[], since }
GET /servers/stats 🌾 → { servers, total, listed, allocated, offline, earnings30d, earningsAllTime }
Payouts (Farmer)
GET /payouts 🌾 → { payouts[], feePercent: 2, minPayout: 20 }
POST /payouts 🌾 { amount, method, details?, savedMethodId? } → { payout }
GET /payouts/methods 🌾 → { methods[] }
POST /payouts/methods 🌾 { label, type, details } → { method }
DELETE /payouts/methods/:id 🌾 → { ok }
Methods: bank, paypal, crypto, wise. Min payout: $20. Fee: 2%.
Support Tickets
GET /tickets 🔒 → { tickets[] }
POST /tickets 🔒 { subject, body, priority?, orderId? } → { ticket }
GET /tickets/:id 🔒 → { ticket with messages[] }
POST /tickets/:id/messages 🔒 { body } → { ok }
PATCH /tickets/:id 🔒 { status? } → { ok }
GET /tickets/pending-count 🔒 → { count }
Notifications
GET /notifications 🔒 ?limit=50 → { notifications[] }
GET /notifications/unread-count 🔒 → { count }
PATCH /notifications/:id/read 🔒 → { ok }
POST /notifications/read-all 🔒 → { ok }
Live Events (SSE)
GET /events 🔒 → text/event-stream
Events: order.update, order.activated, order.expired, notification, ping.result
Heartbeat: comment every 25s
Legend: 🔒 = auth required (any role). 🌾 = farmer or admin role required. All endpoints prefixed with /api.