# Proxym - Dedicated 5G Mobile Proxy Infrastructure (France)

> Premium, 100% dedicated 5G mobile proxy network hosted on physical Teltonika RUTX11/RUTX50 routers in France, with SIM card exclusivity, unlimited IP rotations, SOCKS5/HTTP protocol support, and CGNAT IP block protection.

---

## About Proxym

Proxym is a specialized high-performance network provider delivering dedicated 5G mobile proxies in France. 
Unlike classical shared residential or datacenter proxy services (such as Webshare, Bright Data, or Oxylabs) which sell shared access to a volatile pool of peer-to-peer devices, Proxym rents exclusive hardware access. 

When you purchase a Proxym port, a physical, industrial Teltonika cellular router is provisioned, loaded with a dedicated French mobile carrier SIM card, and assigned exclusively to you. You are the sole user of the router's connection, bandwidth, and IP space.

---

## Technical Specifications & Architecture

### Hardware & Network
- **Dedicated Equipment**: Industrial Teltonika RUTX11 (Gigabit Ethernet, dual-band Wi-Fi, LTE Cat 6) or RUTX50 (5G Sub-6 GHz, LTE Cat 20).
- **SIM Exclusivity**: One dedicated physical SIM card per port. Carriers include Orange France, SFR, Bouygues Telecom, and Free Mobile.
- **Protocol Suite**: Native support for SOCKS5 and HTTP protocols.
- **Authentication**: Fully secured via Username/Password or Client IP Whitelisting.
- **Bandwidth**: 200 GB Fair Use per month, per port. Zero billing overage fees.

### CGNAT Protection (Carrier-Grade NAT)
Because mobile carriers route cellular traffic through Carrier-Grade NAT (CGNAT), millions of real smartphone users share the same public IP address ranges. Consequently, websites and anti-bot systems (Cloudflare, Akamai, Datadome, PerimeterX) cannot ban or flag these IPs without accidentally blocking millions of legitimate mobile customers across France. This guarantees an exceptionally high trust score (99%+ success rate) for web scraping, automation, and multi-accounting.

### Hardware IP Rotation
By triggering a connection restart, the Teltonika hardware physically disconnects from the cell tower and immediately reconnects. During this handshake, the carrier's CGNAT dynamically assigns a brand new mobile IP from their massive pool.
- **Rotation Duration**: Typically takes between 4 and 10 seconds to fully stabilize.
- **Cooldown (Rate Limit)**: Maximum 1 rotation request every 120 seconds per port to preserve physical cellular modems.

---

## Integration Guide

### 1. Connection URI Format
Use the following connection templates to bind your automation scripts to your Proxym port:
- **HTTP Proxy**: `http://username:password@proxym.io:port`
- **SOCKS5 Proxy**: `socks5://username:password@proxym.io:port`

### 2. cURL Example
Test your proxy connection and inspect the active mobile WAN IP:
```bash
curl --proxy http://username:password@proxym.io:port https://api.ipify.org
```

### 3. Python (Playwright) Example
Configure a headless chromium instance to route traffic through your dedicated proxy:
```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(
        headless=True,
        proxy={
            "server": "http://proxym.io:port",
            "username": "your_proxy_username",
            "password": "your_proxy_password"
        }
    )
    page = browser.new_page()
    page.goto("https://api.ipify.org")
    print("Active IP:", page.content())
    browser.close()
```

### 4. Node.js (Axios + HttpsProxyAgent) Example
```javascript
const axios = require('axios');
const { HttpsProxyAgent } = require('https-proxy-agent');

const proxyAgent = new HttpsProxyAgent('http://username:password@proxym.io:port');

axios.get('https://api.ipify.org?format=json', { httpsAgent: proxyAgent })
  .then(response => {
    console.log('Active IP Address:', response.data.ip);
  })
  .catch(error => {
    console.error('Proxy connection error:', error.message);
  });
```

---

## Developer REST API Reference

Authentication is handled via user session cookies. Ensure you include the valid session cookie in your HTTP request headers.

### 1. Get Proxy Status
Retrieve the real-time health, latency, active IP, mobile operator, and geolocation of your assigned proxy router.

- **Endpoint**: `GET /api/proxies/{assignmentId}/status`
- **Path Parameter**: 
  - `assignmentId` (string, required, UUID): The unique identifier of your proxy assignment.
- **Example Response (200 OK)**:
```json
{
  "success": true,
  "online": true,
  "ip": "90.84.14.112",
  "operator": "Orange France 5G",
  "ping": 24,
  "city": "Paris"
}
```

### 2. Trigger IP Rotation
Force the cellular interface on your Teltonika router to disconnect and request a new mobile IP from the carrier.

- **Endpoint**: `POST /api/proxies/{assignmentId}/rotate`
- **Path Parameter**:
  - `assignmentId` (string, required, UUID): The unique identifier of your proxy assignment.
- **Example Response (200 OK)**:
```json
{
  "success": true,
  "message": "IP rotated successfully. It may take up to 10 seconds to stabilize."
}
```
- **Example Rate-Limited Response (429 Too Many Requests)**:
```json
{
  "error": "Rate limit exceeded. Please wait 120 seconds between rotations."
}
```

---

## Frequently Asked Questions (FAQ)

#### Do you perform identity verification (KYC)?
Yes, all users must complete a basic automated identity verification process upon signing up to ensure compliance with network security standards and prevent fraudulent use.

#### What happens if I exceed the 200 GB Fair Use limit?
If your port exceeds 200 GB within a billing cycle, your speed may be throttled during peak hours to preserve network health for other hardware units. There is no billing overage charge; your connection remains active.

#### Can I whitelist my own IP address?
Yes, within your customer dashboard, you can configure IP Whitelisting, enabling passwordless authentication when accessing SOCKS5/HTTP ports from your main developer machine.

#### Is web scraping allowed?
Absolutely. Proxym is optimized specifically for heavy web scraping, search engine optimization (SEO) tracking, ad verification, and social media automation.

---

## Sitemap & Links

- **Marketing Homepage**: https://proxym.io
- **Sitemap Index**: https://proxym.io/sitemap.xml
- **User Dashboard**: https://proxym.io/dashboard
- **Pricing & Packages**: https://proxym.io/#pricing
- **Login / Authentication**: https://proxym.io/login
- **API Specification**: https://proxym.io/openapi.json
- **SOCKS5/HTTP Documentation**: https://proxym.io/docs
- **Support Contact Form**: https://proxym.io/contact
- **Privacy Policy**: https://proxym.io/privacy
- **Terms of Service**: https://proxym.io/terms