# AgentCamo Proxy Session API

> AgentCamo Proxy Session API is a paid API for AI agents from api.agentcamo.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Provisions a geo-targeted proxy or VPN session (residential, mobile/5G, SOCKS5, or WireGuard) with a configurable TTL and exit IP from any of 249 countries.

## Facts

- Endpoint: POST https://api.agentcamo.xyz/sessions
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-agentcamo-xyz-ac95f6a3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GFy8GPG37BPxy_NN96f5B

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-agentcamo-xyz-ac95f6a3 -d '<json body>'
```

Example prompt: Get me a mobile carrier IP (T-Mobile or Verizon pool) exiting in the US as a SOCKS5 proxy, valid for 10 minutes, so I can run a request that needs to look like real mobile traffic.

## When to prefer this

Choose this endpoint when an AI agent needs a fresh, short-lived geo-targeted proxy or VPN session without account registration — especially for mobile/carrier IP pools (T-Mobile, Verizon) to bypass bot detection, mid-session geo-swapping across 249 countries, or when WireGuard full-tunnel is needed instead of HTTP/SOCKS5. Prefer over alternatives when payment via USDC micropayment (x402) is acceptable and no persistent account is desired.

## Known failure modes

- Invalid or unsupported country code returns 4xx with error message
- TTL out of range (outside 1-30 minutes) returns validation error
- Unsupported mode/proxyType combination returns 4xx
- Payment failure or insufficient USDC balance returns 402
- Session expired before use returns stale credentials error
- WireGuard mode unavailable in certain regions returns 503

## How this service works

Returns proxy credentials for a geo-targeted exit IP. Residential, mobile/5G, SOCKS5, WireGuard. 249 countries, mid-session geo-swap. No signup.

## Output

Returns proxy credentials for the provisioned session — including host, port, username/password for HTTP/SOCKS5 modes, or a WireGuard config for full-tunnel mode — along with the assigned exit IP country and session expiry timestamp.

## Example request

```json
{
 "ttl": 600,
 "mode": "socks5",
 "proxyType": "mobile",
 "countryCode": "US"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ttl": {
   "type": "number",
   "description": "Session TTL in minutes, 1-30 (default: 5)"
  },
  "mode": {
   "enum": [
    "http",
    "wireguard",
    "socks5"
   ],
   "type": "string",
   "description": "Transport mode. http = residential/mobile (set proxyType), wireguard = full-tunnel VPN, socks5 = SOCKS5 proxy"
  },
  "identity": {
   "type": "string",
   "description": "Optional agent identity tag"
  },
  "proxyType": {
   "enum": [
    "residential",
    "mobile"
   ],
   "type": "string",
   "description": "IP pool type. mobile = carrier IPs (T-Mobile, Verizon) for bot-detection bypass (default: residential)"
  },
  "countryCode": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2 country code for exit IP"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ttl": 300,
  "mode": "http",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uSWQiOiI3ZjhiNTk4NC1hMWMzLTRlMmYtYjlkNy0zYzhlMWYyYTZiNGQifQ.placeholder",
  "country": "us",
  "expiresAt": "2026-03-20T12:05:00.000Z",
  "proxyAuth": "7f8b5984-a1c3-4e2f-b9d7-3c8e1f2a6b4d:eyJhbGciOiJIUzI1NiJ9.placeholder",
  "proxyHost": "api.agentcamo.xyz",
  "proxyPort": 8080,
  "proxyType": "residential",
  "sessionId": "7f8b5984-a1c3-4e2f-b9d7-3c8e1f2a6b4d",
  "ttl_remaining": 300
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-agentcamo-xyz-ac95f6a3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentcamo.xyz](https://www.zero.xyz/host/api.agentcamo.xyz/llms.txt)