Skip to main content
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"}
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

​
id
string
required
The requestId returned by POST /quote-requests.

​
Events

​
best_quote
event
Emitted whenever the best-quote payload changes. Data:
​
closed
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"}