The Problem
AI Agents are not traditional bots. Unlike simple web scrapers, they navigate websites the way humans do — clicking, scrolling, and interacting with dynamic content. But getting them treated like humans is another challenge entirely. Residential IPs are a critical piece of that puzzle.
SpaceRouter provides Residential IPs with agent-native tooling (Skill, CLI, SDK, API)
Features
| HTTP & SOCKS5 | Dual-protocol proxy support. HTTP on port 8080, SOCKS5 on port 1080. Same residential node pool behind both. |
| Geographic Targeting | Route requests through specific countries using ISO 3166-1 codes. Need a Korean IP? Set X-SpaceRouter-Region: KR. |
| Zero Code Changes | Standard proxy protocol. Just set your proxy URL and authenticate with your API key. Works with any HTTP client. |
| Intelligent Routing | Health-scored node selection with weighted preferences. Requests route through the best available node automatically. |
| Security Built In | mTLS between components, SSRF protection, DNS rebinding prevention, rate limiting, and full header stripping before reaching target sites. |
| Request Tracing | Every request gets a unique X-SpaceRouter-Request-Id for end-to-end debugging across the entire routing path. |
| Distributed Nodes | Home Nodes run on residential machines with automatic NAT traversal via UPnP — no manual router configuration needed. |
How It Works
Your AI Agent
|
| HTTP or SOCKS5
v
+-----------------+
| Proxy Gateway | Authenticates, rate-limits, selects route
+-----------------+
|
| mTLS
v
+--------------------+
| Coordination API | Node registry, IP classification, health scores
+--------------------+
|
v
+--------------------+
| Home Node | Residential machine with real ISP connection
+--------------------+
|
v
Target Website Sees residential IP, serves content normally
- Your agent sends a request through the Proxy Gateway using standard proxy protocol.
- The Gateway validates your API key and checks rate limits.
- The Coordination API selects the best Home Node based on health, geography, and IP type preference.
- The Home Node forwards your request from its residential IP to the target.
- The response flows back through the same path. The target only ever sees a residential IP.
Usage Examples
curl (HTTP Proxy)
curl -x http://sr_live_YOUR_API_KEY@gateway.spacerouter.io:8080 \
https://httpbin.org/ip
curl (SOCKS5 Proxy)
curl --socks5 gateway.spacerouter.io:1080 \
--proxy-user sr_live_YOUR_API_KEY: \
https://httpbin.org/ip
curl (with Geographic Targeting)
curl -x http://sr_live_YOUR_API_KEY@gateway.spacerouter.io:8080 \
-H "X-SpaceRouter-Region: KR" \
https://httpbin.org/ip
Python SDK
from spacerouter import AsyncSpaceRouter
async with AsyncSpaceRouter(
api_key="sr_live_YOUR_KEY",
gateway_url="https://gateway.spacerouter.io:8080",
) as router:
response = await router.get(
"https://target-website.com/data",
region="KR",
ip_type="residential",
)
print(response.json())
JavaScript SDK
import { SpaceRouter } from "spacerouter";
const router = new SpaceRouter({
apiKey: "sr_live_YOUR_KEY",
gatewayUrl: "https://gateway.spacerouter.io:8080",
});
const response = await router.get("https://httpbin.org/ip", {
region: "KR",
ipType: "residential",
});
console.log(response.body);
Architecture
| Component | Role |
|---|---|
| Proxy Gateway | Agent-facing entry point. Handles HTTP and SOCKS5 proxy protocols, authentication, rate limiting, and route selection. |
| Coordination API | Central control plane. Manages the node registry, API keys, IP classification (via IPinfo.io), and health-based routing. |
| Home Node | Residential exit point. Runs on home machines behind NAT, auto-configures port forwarding via UPnP, and proxies traffic from its residential IP. |
Get Started
1. Create an API Key
curl -X POST https://coordination.spacerouter.org/api-keys \
-H "Content-Type: application/json" \
-d '{"name": "my-agent"}'
2. Use the Proxy
curl -x http://YOUR_API_KEY@gateway.spacerouter.org:8080 \
https://httpbin.org/ip
That's it. Your request is now routed through a residential IP.
SDKs
| Python | pip install spacerouter |
Sync + async, HTTP + SOCKS5 |
| JavaScript | npm install @spacenetwork/spacerouter |
HTTP proxy with TypeScript support |
Roadmap
Vision
AI agents are the new users of the internet. SpaceRouter is their network.
Starting with residential IP addresses that give agents private, unrestricted access to the web, SpaceRouter is building the world's fastest privacy-preserving, decentralized routing network — token-incentivized, inspired by Tor, and destined to scale across the globe and into space through Space Network, a decentralized satellite telecommunications network powered by Spacecoin.
| Phase | Milestone | Description |
|---|---|---|
| 1.1 | MVP Launch | CLI setup, Python & JS SDKs, HTTP & SOCKS5 proxy, geographic targeting. Live now. |
| 1.2 | Proxy Nodes + Staking | Spacecoin staking, on-chain reputation for node operators, incentive payouts. |
| 1.3 | Payments | Spacecoin payment settlement with cryptographic receipts. |
| 2 | Entry Nodes | Distributed entry nodes replace the cloud gateway. Same SDK interface. |
| 3 | Multi-Hop Routing | Three-hop circuits (guard → middle → exit) for full privacy. |
| 4 | Full Decentralization | No central coordination. Agents read the node registry from the blockchain. On-chain payments and reputation. |