# 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).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spacecoin.org/spacerouter-proxy/service-user-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.