Skip to main content

Base URL

https://api.totalis.com
For local development:
http://localhost:3000

Authentication

The API supports two authentication methods:

Privy JWT Token

For web applications using Privy authentication.
Authorization: Bearer <token>
Supported for REST API only.

API Key

For programmatic access, bots, and WebSocket connections.
UCALLEDIT_API_KEY: api_live_xxxxxxxxxxxxxxxxxxxxx
Supported for REST API + WebSocket.
WebSocket connections require API keys. Privy JWT tokens are not supported for WebSocket.

Endpoint Groups

Error Format

All errors follow a consistent format:
{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {}
  }
}
Common error codes include UNAUTHORIZED, FORBIDDEN, NOT_FOUND, INVALID_REQUEST, CONFLICT, INSUFFICIENT_BALANCE, RFQ_EXPIRED, QUOTE_EXPIRED, and INTERNAL_ERROR.