Realtime Sessions

POST /realtime/sessions creates an OpenAI Realtime session with Dexter identity, wallet context, and MCP tools injected.

Request

URL: https://api.dexter.cash/realtime/sessions

{
  "model": "gpt-realtime",
  "voice": "verse",
  "supabaseAccessToken": "eyJhbGciOiJIUzI1NiIs..."
}

Field	Type	Required	Description
`model`	string	No	Realtime model (default: server-configured)
`voice`	string	No	Voice ID — `cedar`, `verse`, `alloy`, etc. Default: `cedar`
`supabaseAccessToken`	string	No	For authenticated sessions. Omit for guest.
`guestProfile`	object	No	Override guest label and instructions

Guest sessions require no auth — just send an empty body {}.

Response (200)

{
  "id": "sess_abc123",
  "object": "realtime.session",
  "model": "gpt-realtime",
  "client_secret": {
    "value": "ek_ephemeral_token_here",
    "expires_at": 1738742400
  },
  "voice": "cedar",
  "tools": [...],
  "dexter_session": {
    "type": "guest",
    "user": null,
    "guest": { "session_id": "550e8400-..." },
    "wallet": null,
    "prompt_profile": null
  }
}

Field	Type	Description
`client_secret.value`	string	Ephemeral token for WebRTC connection
`client_secret.expires_at`	number	Expiry timestamp (seconds)
`dexter_session.type`	string	`"guest"` or `"user"`
`dexter_session.wallet`	object	`{ public_key, label }` if wallet assigned
`tools`	array	MCP tools available in the session

WebRTC Setup

Use the ephemeral token to connect to the OpenAI Realtime WebSocket:

wss://api.openai.com/v1/realtime
Authorization: Bearer <client_secret.value>
OpenAI-Beta: realtime=v1

The session includes Dexter MCP tools, so the voice agent can search the marketplace, check pricing, and execute payments through the conversation.

Realtime Sessions

Request

Response (200)

WebRTC Setup

On this page