Service User Guide

Audience: Developers, businesses, and AI agents that want to use the SpaceRouter proxy network

Quick Start

Send your first request through SpaceRouter Proxy in under five minutes.

You'll need a wallet with a small amount of SPACE (and a little CTC for gas). If you don't have one yet, see Pay with SPACE for the full setup walkthrough.

Try it with the CLI

Install the CLI, deposit some SPACE, and make a paid request:

pip install spacerouter

export SR_GATEWAY_URL=https://gateway.spacerouter.org
export SR_GATEWAY_MANAGEMENT_URL=https://gateway.spacerouter.org:8081
export SR_ESCROW_PRIVATE_KEY=0xYOUR_PRIVATE_KEY
export SR_ESCROW_CONTRACT_ADDRESS=0x...   # see Reference for the current value
export SR_ESCROW_CHAIN_RPC=https://mainnet3.creditcoin.network

# One-time: deposit SPACE into the escrow contract for your wallet.
spacerouter escrow deposit 10000000000000000000   # 10 SPACE

# Send a paid request.
spacerouter request get https://httpbin.org/ip --pay

You should see a JSON response with the IP of the residential node that served your request.

Geo targeting

Add --region and --ip-type flags to target a country and IP type:

spacerouter request get https://httpbin.org/ip --pay --region KR --ip-type residential

• Region — any 2-letter ISO country code (e.g. US, KR, BR).

• IP type — one of residential, mobile, business, or hosting.

No nodes match?

If no Provider currently matches your region/type combination, the gateway returns HTTP 503. Drop the type filter or pick a more popular region and try again.

Use an SDK

• Python SDK — pip install spacerouter — sync & async clients, EIP-712 receipts, escrow client.

• JavaScript SDK — npm install @spacenetwork/spacerouter — Node.js (Undici-based), TypeScript types included.

Where to next

• Read the full Pay with SPACE walkthrough.

• Read about the core concepts.

• If something fails, check Errors & Troubleshooting.