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"
}
Trading
Stream Quotes
Server-Sent Events stream of live best-quote pricing for an open quote request. The preferred transport for live pricing in the trading UI.
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
event
Emitted when the request ends (committed, expired, or cancelled). Data:
{ "requestId": "..." }.Errors
Returns HTTP404 (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"
}
Was this page helpful?