Skip to content
Tradr docs

Start a new conversation and stream the assistant reply (SSE).

POST
/api/advisor/conversations/new/messages/stream
curl --request POST \
  --url https://api.tradr.cloud/api/advisor/conversations/new/messages/stream \
  --header 'Content-Type: application/json' \
  --data '{ "attachments": [ { "dataBase64": "example", "format": "png", "type": "image" } ], "clientMessageId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "personaId": "example", "text": "example" }'

New-conversation variant of the streaming endpoint. The provider and model are seeded from the caller’s stored provider key. Same SSE frame shapes and rate limit (30 / 60 s) as the existing-conversation endpoint.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
attachments
Array<object>
<= 4 items
object
dataBase64
string
<= 4500000 characters
format
string
Allowed values: png jpeg webp
type
string
Allowed values: image
clientMessageId
required
string format: uuid
personaId
string
text
required
string
>= 1 characters <= 50000 characters

Responses

Section titled “Responses”

200

Section titled “200”

Server-Sent Event stream.

Media typetext/event-stream
string

400

Section titled “400”

Validation / image / cap error envelope (IMAGE_TOO_LARGE above the per-image byte cap).

402

Section titled “402”

Platform billing refusal — INSUFFICIENT_CREDITS / ALLOWANCE_EXHAUSTED (allowance model + allowance and credits exhausted) / INSUFFICIENT_CREDITS_ALLOWANCE_AVAILABLE (non-allowance model + free allowance turns remain) / MODEL_NOT_AVAILABLE / BILLING_NOT_AVAILABLE.

403

Section titled “403”

Monthly advisor image quota exceeded for the user’s tier (TIER_LIMIT_IMAGES) — text-only turns unaffected.

413

Section titled “413”

Request body exceeds the byte-cap floor (PAYLOAD_TOO_LARGE).

429

Section titled “429”

Stream in progress or rate limit.

500

Section titled “500”

Provider-key decryption failure.