Stream Quotes

curl -N https://api.convallax.com/quote-requests/req-789/stream

event: best_quote
data: {"bestQuote":{"maker_id":"mm-1","quote_id":"8f3c2b1a-...","side":"buy","price":0.12,"size":10},"quoteCount":3,"status":"open"}

event: best_quote
data: {"bestQuote":{"maker_id":"mm-2","quote_id":"a1b2c3d4-...","side":"buy","price":0.11,"size":10},"quoteCount":4,"status":"open"}

event: closed
data: {"requestId":"req-789"}

{
  "success": false,
  "error": "Quote request not found"
}

GET

quote-requests

:id

stream

curl -N https://api.convallax.com/quote-requests/req-789/stream

event: best_quote
data: {"bestQuote":{"maker_id":"mm-1","quote_id":"8f3c2b1a-...","side":"buy","price":0.12,"size":10},"quoteCount":3,"status":"open"}

event: best_quote
data: {"bestQuote":{"maker_id":"mm-2","quote_id":"a1b2c3d4-...","side":"buy","price":0.11,"size":10},"quoteCount":4,"status":"open"}

event: closed
data: {"requestId":"req-789"}

{
  "success": false,
  "error": "Quote request not found"
}

Subscribe to a Server-Sent Events stream of live best-quote pricing while the user builds their slip. This is the preferred transport for live pricing — it pushes an update only when the best quote changes, replacing the old ~1s polling of GET /quote-requests/:id/quotes (which remains available as a fallback). The response has Content-Type: text/event-stream. Use the browser EventSource API or any SSE-capable client. No API key is required — trading endpoints are open.

Path Parameters

string

required

The requestId returned by POST /quote-requests.

Events

event

Emitted whenever the best-quote payload changes. Data:

Show best_quote data

object | null

The current best quote (including maker_id and quote_id), or null if no valid quotes have been received.

number

Total number of valid quotes received.

string

Request status, e.g. "open".

event

Emitted when the request ends (committed, expired, or cancelled). Data: { "requestId": "..." }.

Errors

Returns HTTP 404 (JSON) if the quote request does not exist.

curl -N https://api.convallax.com/quote-requests/req-789/stream

event: best_quote
data: {"bestQuote":{"maker_id":"mm-1","quote_id":"8f3c2b1a-...","side":"buy","price":0.12,"size":10},"quoteCount":3,"status":"open"}

event: best_quote
data: {"bestQuote":{"maker_id":"mm-2","quote_id":"a1b2c3d4-...","side":"buy","price":0.11,"size":10},"quoteCount":4,"status":"open"}

event: closed
data: {"requestId":"req-789"}

{
  "success": false,
  "error": "Quote request not found"
}

Create Quote Request Poll Quotes

Overview

Series

Trading

Market Maker

User

Settlement

On-Chain Contracts

Testnet

Path Parameters

Events

Errors

​Path Parameters

​Events

​Errors

Path Parameters

Events

Errors