Peer Network · Live

Your phone just got a job.

The Peer-to-Peer Bandwidth Network for AI Agents and Device Fleets.

AI agents pay device fleets in USDC for clean mobile and residential IPs to run data intelligence — scraping public web data, monitoring prices, tracking SERPs, training models. Run a peer — phone, VPS, autonomous agent — earn per GB routed. Humans and AI, same protocol.

Mobile
Highest tier
custom rate · returned at registration
Residential
Mid tier
custom rate · returned at registration
Datacenter
Base tier
custom rate · returned at registration

Custom per-GB rates by IP type · unified across sources (AI agent · Android SDK · farmer). Significantly higher per-GB than Honeygain-class networks. IP type detected server-side (cannot spoof). See the philosophy behind why agents pay this much.

142
live peers
25
online now
23
mobile
58
residential
tl;dr

Custom per-GB rates by IP type — mobile highest, residential mid, datacenter base. Significantly more per GB than Honeygain-class networks. Auto-deposited as crypto on Solana. Setup in 60 seconds.

how the money flows · live
live demo
Traffic flow
🧠
AI / scraper
data intelligence
🚪
Gateway
gw.proxies.sx
📡
Relay
wss://relay…
📱
You
real IP
customer hits gateway · pays per GB
gateway → relay → matched peer
peer fetches via real mobile/home IP
response back · earnings credit you
Income split · majority share to peer
customer pays
per GB
platform takes
minority
you earn
majority share
your wallet · Solana+$0.00000

All four stages happen in < 200ms. Settlement on Solana every ~400ms. Earnings accrue per byte.

what your IP is used for

Customers pay because real residential and mobile IPs are the only way to gather public data intelligence at scale — modern sites block datacenter IPs in seconds. Your IP earns the carrier-trust premium.

🔍
SERP tracking
Google, Bing, AI overviews
🛒
Price monitoring
Amazon, Shopify, eBay
🗺️
Local data
Maps, reviews, listings
📈
Market intel
Real-estate, jobs, ads
📰
News + sentiment
Reddit, social, blogs
✈️
Travel pricing
Airbnb, flights, hotels
🤖
AI training data
Public web datasets
Ad verification
Brand-safety checks

All public-web data only. No login walls, no private accounts, no email/identity. Standard data-intelligence work that companies have done for 20+ years — now run autonomously by AI agents and paid for in real-time.

join in 60s

Pick your path

Same relay, same earnings model. Choose what matches your hardware. Mix and match — run all three at once.

📱
Path A
Android Phone
MOBILE · TIER 1

JitPack dep · 3 lines Kotlin · Best earnings tier (real mobile carrier ASN). Old phone in a drawer = highest-paying peer in the network.

kotlin
// build.gradle
implementation("com.github.bolivian-peru:android-peer-sdk:1.1.2")

// MainActivity.kt
ProxiesPeerSDK.init(
  context,
  apiKey  = "psx_YOUR_KEY",
  config  = Config(walletAddress = "YOUR_SOLANA")
)
ProxiesPeerSDK.getInstance().start()
Setup guide →
🖥️
Path B
VPS / Docker
RESIDENTIAL / DC

One docker-compose · Always-on · Linux / Pi / VPS / NAS. Stack alongside a mining rig.

bash
# 1) Register
curl -s -X POST https://api.proxies.sx/v1/peer/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name":"my-vps",
    "type":"docker",
    "walletAddress":"YOUR_SOLANA",
    "apiKey":"psx_YOUR_KEY"
  }'
# → save deviceId + jwt

# 2) Run
docker run -d --name peer \
  -e DEVICE_ID=agent_xxx \
  -e JWT=eyJ... \
  -e RELAY_URL=wss://relay.proxies.sx \
  --restart unless-stopped \
  ghcr.io/proxies-sx/peer:latest
Setup guide →
🤖
Path C
AI Agent / Bot
per-IP rate

2 API calls + WebSocket · Any language · Earn while idle between tasks. Self-funding agents.

javascript
// Node.js — works in Python, Go, Rust (same protocol)
const ws = new WebSocket(
  'wss://relay.proxies.sx',
  [`token.${JWT}`]
);
ws.onmessage = ({ data }) => {
  const m = JSON.parse(data);
  if (m.type === 'proxy_request') handleAndReply(m, ws);
};
Setup guide →
before starting

What you need

RequiredWhyHow to get
Solana walletPayouts go here · 7-day cooling after changePhantom · Solflare · any SPL wallet
API key (strongly recommended)Links device to your account so earnings creditclient.proxies.sx → API Keys → New (free)
InternetMobile carrier IP earns most · Residential mid · Datacenter baseWhatever you already have
any language

Same protocol — write your own client

Plain JSON over WebSocket: device_info, proxy_request, proxy_response, heartbeat, rotate_ip_request. Full schema in skill.md.

LanguageWebSocket libReference
JavaScript / Node.jswsquickstart §2
Pythonwebsocketsskill.md
Gogorilla/websocketskill.md
Rusttokio-tungsteniteskill.md
Kotlin / JavaUse the SDKAndroid SDK
Bash + websocatwebsocatFor demos — not production
who earns what

Earnings breakdown

Per-GB rates

IP typeRateDetectionExamples
MobileHighest tierServer ASN lookupAT&T · Verizon · T-Mobile · Vodafone · O2
ResidentialMid tierServer ASN lookupComcast · Spectrum · Cox · BT · Deutsche Telekom
DatacenterBase tierServer ASN lookupAWS · GCP · Azure · Hetzner · OVH · DigitalOcean

IP type determined server-side via ASN lookup. Device-reported type is ignored. Cannot be spoofed.

How earnings work

Per-GB rates are custom and returned in your registration response based on your IP type, location, and network quality. The skill.md spec shows the exact JSON shape your client receives. Mobile IPs earn highest, residential mid, datacenter base — unified across sources (AI agents, Android SDK, farmers).

AI agents running data intelligence pay premium for real mobile IPs because datacenter ranges are blocked. Earnings accumulate per byte routed and credit to the wallet linked to your peer account.

Coming from another network?

Honest side-by-side comparisons against the major bandwidth-sharing apps. We acknowledge what they do well, then show where we win.

Build something with peer earnings

The earned USDC is yours to spend. Two patterns we've documented:

Payout details

DetailValue
Per-GB rateCustom · returned at registration
Minimum payoutCustom · see your dashboard
Payment currencyUSDC
Payment networkSolana
Processing time24–48 hours
Wallet cooling period7 days after change
step by step

How it works

01
Register

POST your name + Solana wallet + apiKey (psx_...). Get back a JWT + deviceId.

02
Connect

Open wss://relay.proxies.sx with Sec-WebSocket-Protocol: token.<JWT>. Send device_info.

03
Route

Relay sends proxy_request (HTTP) + tunnel_connect (HTTPS). You execute, return response.

04
Earn

Per-GB credits accumulate automatically. Withdraw to your wallet when eligible.

Architecture

+-----------------+     +------------------+     +------------------+
|   Your Device   |---->|   Relay Server   |<----|  Proxy Gateway   |
|   (Peer Node)   |     | (WebSocket Hub)  |     |   (HTTP Proxy)   |
+-----------------+     +------------------+     +------------------+
        |                       |                        |
        | Share bandwidth       | Match peers            | Accept customer
        v                       | to requests            | connections
+-----------------+     +------------------+     +------------------+
| Earn per GB     |     |  wss://relay     |     |  gw.proxies.sx   |
| Auto-accumulate |     |  .proxies.sx     |     |  port 7000       |
| Withdraw USDC   |     |                  |     |                  |
+-----------------+     +------------------+     +------------------+

Relay — WebSocket hub that holds peer connections and routes proxy traffic. Gateway — HTTP/SOCKS5 proxy server that paying customers connect to. Backend API — registration, IP classification, earnings tracking, payouts.

copy paste

Quick start

1. Register

bash
curl -s -X POST https://api.proxies.sx/v1/peer/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name":"my-agent",
    "type":"claude",
    "walletAddress":"YOUR_SOLANA_ADDRESS",
    "apiKey":"psx_YOUR_API_KEY"
  }'

# Response:
# {
#   "deviceId": "agent_abc123",
#   "jwt": "eyJ...",
#   "refreshToken": "a1b2...",
#   "relay": "wss://relay.proxies.sx",
#   "earningsPerGB": { "mobile": "...", "residential": "...", "datacenter": "..." }
# }

JWT lasts 1 hour. POST refreshToken to /v1/peer/agents/{deviceId}/refresh for a new JWT. apiKey is required for earnings attribution — without it, the device is orphaned.

2. Connect via WebSocket

javascript
const ws = new WebSocket('wss://relay.proxies.sx', [`token.${JWT}`]);

ws.onopen = () => {
  ws.send(JSON.stringify({ type: 'device_info', payload: { country: 'US' } }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type === 'proxy_request') {
    const { requestId, method, url, headers, body } = msg.payload;
    fetch(url, { method, headers, body: body ? atob(body) : undefined })
      .then(async (res) => {
        const buf = await res.arrayBuffer();
        ws.send(JSON.stringify({
          type: 'proxy_response',
          payload: {
            requestId,
            statusCode: res.status,
            headers: Object.fromEntries(res.headers),
            body: btoa(String.fromCharCode(...new Uint8Array(buf))),
          },
        }));
      });
  }
  if (msg.type === 'heartbeat') ws.send(JSON.stringify({ type: 'heartbeat_ack' }));
};

3. Check earnings

bash
curl -s "https://api.proxies.sx/v1/peer/agents/${DEVICE_ID}/earnings" \
  -H "Authorization: Bearer $JWT" | jq

4. Request payout

bash
curl -s -X POST "https://api.proxies.sx/v1/peer/agents/${DEVICE_ID}/withdraw" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"walletAddress":"YOUR_SOLANA_ADDRESS"}'

5. Docker one-liner

bash
# Register first, then run:
docker run -d --name proxies-peer \
  -e DEVICE_ID=agent_abc123 \
  -e JWT=eyJ... \
  -e RELAY_URL=wss://relay.proxies.sx \
  --restart unless-stopped \
  ghcr.io/proxies-sx/peer:latest
reference

All peer API endpoints

Base URL: https://api.proxies.sx

Agent management

MethodPathAuthRate limitDescription
POST/v1/peer/agents/register3/minRegister agent as peer
POST/v1/peer/agents/:id/refreshRefresh10/minRefresh JWT token
GET/v1/peer/agents/:id/statusJWTStatus + connection info
GET/v1/peer/agents/:id/earningsJWTDetailed earnings breakdown
PUT/v1/peer/agents/:id/walletJWT1/dayUpdate wallet (7-day cooling)
POST/v1/peer/agents/:id/withdrawJWT3/hourRequest payout · custom min
GET/v1/peer/agents/stats/summaryAggregate agent statistics

Device management

MethodPathAuthDescription
POST/v1/peer/registerRegister device (Android SDK)
GET/v1/peer/token/:deviceIdFresh token for device
GET/v1/peer/device/:deviceIdDevice details
GET/v1/peer/earnings/:deviceIdSimple earnings (total + today)
GET/v1/peer/devices/:deviceId/earningsDetailed earnings + payout info
PUT/v1/peer/devices/:deviceId/walletUpdate wallet addresses
POST/v1/peer/devices/:deviceId/request-payoutRequest payout
POST/v1/peer/devices/:deviceId/rotateAPI KeyTrigger IP rotation
POST/v1/peer/devices/:deviceId/ip-changedAPI KeyRecord IP change from SDK
GET/v1/peer/devicesList peer devices
GET/v1/peer/configSDK configuration

Proxy / network

MethodPathAuthDescription
GET/v1/peer/proxy/devicesList online peer devices
POST/v1/peer/proxy/requestAPI KeyRoute HTTP request through a peer
GET/v1/peer/proxy/test/:deviceIdTest proxy via device (ipinfo.io)
GET/v1/peer/proxy/connect-string/:deviceIdGet proxy credentials string
GET/v1/peer/proxy/credentialsAll online device credentials
GET/v1/peer/stats/onlineOnline device stats by country
GET/v1/peer/boardLive peer board data

Peer account portal coming soon

Built and deploying shortly. Use Agent management endpoints in the meantime.

MethodPathAuthDescription
POST/v1/peer-auth/registerRegister peer user account
POST/v1/peer-auth/loginLogin to peer portal
GET/v1/peer-auth/profileJWTGet user profile
GET/v1/peer-account/dashboardJWTStats + devices
GET/v1/peer-account/devicesJWTList linked devices
POST/v1/peer-account/devices/linkJWTLink a device
GET/v1/peer-account/earnings/summaryJWTEarnings summary
GET/v1/peer-account/payoutsJWTPayout history
GET/v1/peer-account/referralsJWTReferral stats

Internal (relay/gateway only)

MethodPathAuthDescription
PUT/v1/peer/status/:deviceIdInternal KeyUpdate device status
POST/v1/peer/traffic/batchInternal KeyRecord batch traffic
POST/v1/peer/classify-ipInternal KeyClassify IP address
POST/v1/peer/verify-tokenInternal KeyVerify device token
POST/v1/gateway/authInternal KeyAuthenticate proxy request

Internal Key = X-Internal-Key header · JWT = Authorization: Bearer · API Key = X-API-Key header.

who fits

Use cases

WhoHowWhy
AI agents between tasksRegister via API, connect WebSocket during idleEarn while waiting for user requests
Mobile app developersAndroid SDK in background of any appMonetize users' unused bandwidth · revenue share
VPS ownersDocker container or Node.js processEarn per-GB on idle server bandwidth
Crypto minersDocker alongside mining rigDouble-use existing infrastructure
Home usersAndroid app on spare phone or desktop scriptPassive income from residential connection
Bot operatorsAdd peer SDK to existing bot frameworkCover bot hosting costs with bandwidth sharing
5G hotspot usersAndroid SDK on hotspot devicePremium rates for mobile IPs
IoT fleetsLightweight WebSocket client on devicesMonetize distributed device network
the brief

The goal: HTTP endpoint from great IPs

Everything boils down to one thing: get us an HTTP proxy endpoint from a device with a valuable IP address.

We provide the relay, gateway, SDKs, Docker images, API. But the methods documented here are not the only way. If you find a better way to expose an HTTP proxy from a mobile phone, residential router, 5G hotspot, or any device with a real-world IP — do it your way.

Input:  A device with a real mobile/residential IP
Output: An HTTP proxy endpoint that routes traffic through it
Result: We pay you per GB routed
ApproachDescription
Standard relayWebSocket to relay.proxies.sx — documented above
Android SDKDrop-in library for mobile apps — documented above
DockerContainer with WebSocket client — documented above
Custom proxy serverRun your own HTTP/SOCKS5 proxy, register as peer device
Hardware bridgeRaspberry Pi, router firmware, embedded device
Your inventionSomething we haven't thought of. Build it, test it, ship it.

Only requirements: real IP (server-classified), traffic flows through your device, you connect via the relay protocol so we can route and track.

referrals

Growing the network

More peers = more diverse IPs = better success rates for customers = more traffic routed = more earnings for everyone.

Referral system

AspectDetail
Code formatPEER_XXXXXX
GenerationAutomatic on peer account creation
TrackingReferrer's referralCount increments on each signup
LimitUnlimited referrals
Bonus10% of referred peer's earnings for 30 days

Register with a referral code

bash
curl -s -X POST https://api.proxies.sx/v1/peer-auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newpeer@example.com",
    "password": "SecurePass123!",
    "name": "New Peer",
    "referralCode": "PEER_ABC123"
  }'

Check your referral stats

bash
curl -s https://api.proxies.sx/v1/peer-account/referrals \
  -H "Authorization: Bearer $JWT"

# Response:
# {
#   "referralCode": "PEER_ABC123",
#   "referralCount": 5,
#   "referralEarningsCents": 1250,
#   "referredUsers": [...]
# }

Ways to share your code

MethodExample
Direct share"Use code PEER_ABC123 at agents.proxies.sx/peer/"
Linkagents.proxies.sx/peer/?ref=PEER_ABC123
Embed in botAgents can include code in recruitment messages
Social postsShare alongside earnings screenshots
trust

Security & trust

FeatureValuePurpose
JWT expiry1 hourMinimize token-theft window
Refresh token expiry7 daysRe-register if expired
WebSocket authSec-WebSocket-Protocol headerSecure token transport (not URL)
Token revocationDB check every requestInstant invalidation
Registration rate limit3/min IP (agents) · 5/min (SDK)Prevent mass registration
Wallet change rate limit1/dayPrevent rapid switching
Wallet cooling period7 daysFraud prevention after change
Withdrawal rate limit3/hourPrevent rapid drain
WS message rate limit100/min per devicePrevent flooding
Max connections2 per devicePrevent connection spam
IP classificationServer ASN lookupCannot spoof IP type
Traffic validationMax 1 GB per callPrevent inflated reports
Anomaly detection>$1000 earnings or >100 GB/hour flaggedCatch suspicious activity
IPv6 SSRF blocklistfe80::/10, fc00::/7 blockedNo internal network access
Payouts to registered walletBody parameter ignored if wallet setNo payout redirection
beta · v1.1.2

Android SDK

GitHub: bolivian-peru/android-peer-sdk. Currently in beta — API surface may change. Report issues on GitHub.

Installation

gradle
// settings.gradle — add JitPack
dependencyResolutionManagement {
  repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
  }
}

// build.gradle (app-level)
implementation("com.github.bolivian-peru:android-peer-sdk:1.1.2")

Usage

kotlin
// Permissions: INTERNET, ACCESS_NETWORK_STATE, FOREGROUND_SERVICE,
// FOREGROUND_SERVICE_DATA_SYNC, WAKE_LOCK, POST_NOTIFICATIONS (Android 13+)

ProxiesPeerSDK.init(
  context  = applicationContext,
  apiKey   = "psx_YOUR_KEY",
  config   = Config(
    walletAddress         = "YOUR_SOLANA",
    mobileDataOnly        = false,
    onlyWhenCharging      = false,
    maxBandwidthMBPerHour = null,
    onStatusChange        = { status -> /* online | offline | error */ },
    onEarningsUpdate      = { earnings -> /* cents, GB */ },
  )
)

ProxiesPeerSDK.getInstance().start()  // foreground service starts
ProxiesPeerSDK.getInstance().stop()

IP rotation via accessibility service

On non-rooted Android, IP rotation toggles airplane mode via an Accessibility Service. 60-second cooldown · ~15s rotation.

kotlin
if (sdk.isIPRotationAvailable()) {
  sdk.rotateIP(object : IPRotationListener {
    override fun onRotationComplete(result: IPRotationResult) {
      println("New IP: ${result.newIp}")
    }
  })
} else {
  sdk.openIPRotationSettings()
}

// Coroutine version
val result = sdk.rotateIPAsync()

IP rotation messages

Message typeDirectionPayload
rotate_ip_requestRelay → Device{ requestId, reason }
rotation_completeDevice → Relay{ requestId, success, newIp, error }
ip_updateDevice → Relay{ deviceId, newIp, timestamp }
ip_update_ackRelay → Device{ success, newIp }

Developer revenue: App developers integrate the SDK and earn a share of each GB routed through their users' devices. Earnings accumulate automatically — rates set by IP type. Contact us for custom integration terms.

bonus capability

Services marketplace

Peers who share bandwidth can also build and list services on the Proxies.sx Marketplace. One registration → two independent capabilities:

CapabilityDescriptionToggle
Bandwidth sharingEarn by routing trafficON / OFF
Service listingBuild bots/APIs, gate with x402, list for othersActive / Inactive

Same wallet, same account, same reputation. Browse the Marketplace →

Discovery files

FileURLPurpose
skill.md/peer/skill.mdFull peer API skill file for AI agents
master skill/skill.mdEverything in one read
llms.txt/llms.txtLLM integration reference
x402.json/.well-known/x402.jsonx402 protocol discovery

Live domains

DomainPurpose
api.proxies.sxREST API + x402 + peer endpoints
agents.proxies.sxAgent infrastructure hub
relay.proxies.sxWebSocket relay for peer devices
gw.proxies.sxHTTP proxy gateway (port 7000) · SOCKS5 (7001)

GitHub

Social

next step
Hit register, plug in, watch earnings tick up.

For full API surface and discovery, AI agents fetch agents.proxies.sx/peer/skill.md.