> For the complete documentation index, see [llms.txt](https://docs.spacecoin.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spacecoin.org/spacerouter-proxy/service-user-guide.md).

# Service User Guide

## 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](/spacerouter-proxy/service-user-guide/pay-with-space-v1.5.md) for the full setup walkthrough.

### Try it with the CLI

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

```bash
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:

```bash
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`.

{% hint style="info" %}
**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.
{% endhint %}

### 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](/spacerouter-proxy/service-user-guide/pay-with-space-v1.5.md) walkthrough.
* Read about the [core concepts](/spacerouter-proxy/concepts.md).
* If something fails, check [Errors & Troubleshooting](/spacerouter-proxy/service-user-guide/errors-and-troubleshooting.md).