SpaceRouter

Residential IP as a Service for AI Agents

Many websites block datacenter IPs. SpaceRouter routes your agent's traffic through real residential connections — transparently, with zero code changes beyond setting a proxy URL.

Get Started


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
  1. Your agent sends a request through the Proxy Gateway using standard proxy protocol.
  2. The Gateway validates your API key and checks rate limits.
  3. The Coordination API selects the best Home Node based on health, geography, and IP type preference.
  4. The Home Node forwards your request from its residential IP to the target.
  5. 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

SDK on GitHub


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.