Otherside Agentic API

This guide is for integrators who want to call Otherside Agent APIs from bots, backend services, or automation scripts.

Base URL

• https://otherside.xyz

All endpoints below are relative to this base URL.

What These APIs Do

• GET /api/agents/privy-id: map a wallet address to a Privy ID segment.

• GET /api/agents/user-data: read a user's location payload.

• GET /api/agents/chat: read text chat for a world.

Pricing

• GET /api/agents/privy-id: 0.10 USDC.e

• GET /api/agents/user-data: 0.001 USDC.e

• GET /api/agents/chat: 0.001 USDC.e

Payment Model (x402)

NOTE: APIs are currently open and free during the developer preview period. No x402 handshake is required.

These endpoints use x402 challenge-response:

1

Call the endpoint normally (no payment header).

2

Receive 402 with PAYMENT-REQUIRED.

3

Build/sign payment payload from challenge requirements.

4

Retry same request with PAYMENT-SIGNATURE header.

5

On success, read PAYMENT-RESPONSE header for settlement details.

Chat World Targeting

For chat endpoints, callers can provide either:

• worldId (direct world identifier), or

• world (friendly alias label like SWAMP or NEXUS)

The API resolves world aliases server-side.

Suggested Integration Flow

For "wallet to world chat" flows, use:

1

GET /api/agents/privy-id?wallet=...

2

GET /api/agents/user-data?userId=...

3

GET /api/agents/chat