Best bid and ask

GET/api/v1/markets/{marketId}/quotePublic

Trading APIprice E4 · size E2 · amount E6 (integers)YES | NO

Best prices on the YES and NO sides (the NO side is the complement of YES; the book has no outcome dimension). An empty side is null, not 0. A single-market query, so minCursor read-your-writes is supported.

Path parameters

marketIdstringpathrequired
Engine market id (read endpoints do not accept a slug unless that endpoint says otherwise)
Example"mkt-0001"

Query parameters

minCursorstringqueryoptional
Read-your-writes continuation point (pass the cursor from the 202 place-order response verbatim). While the projection has not caught up this query returns 404, indistinguishable from "the resource does not exist" — poll with the same cursor.
Example"c1:mkt-0001:184"

Response

200Best prices on both sides

marketstring
Market id
Example"mkt-0001"
yesBidE4integernullable
Best YES bid; null when that side has no resting orders
Example5200
yesAskE4integernullable
Best YES ask; null when that side has no resting orders
Example5300
noBidE4integernullable
Best NO bid (= 10000 − yesAsk)
Example4700
noAskE4integernullable
Best NO ask (= 10000 − yesBid)
Example4800
spreadE4integernullable
Bid-ask spread on the YES side
Example100

Switch status codes in the response example to view errors. For all codes, see the Errors page.

Request

curl -X GET "$BASE_URL/api/v1/markets/mkt-0001/quote"

Response

Best prices on both sides

{
  "market": "mkt-0001",
  "yesBidE4": 5200,
  "yesAskE4": 5300,
  "noBidE4": 4700,
  "noAskE4": 4800,
  "spreadE4": 100
}

Path parameters

marketIdstringpathrequired
Engine market id (read endpoints do not accept a slug unless that endpoint says otherwise)
Example"mkt-0001"

Query parameters

minCursorstringqueryoptional
Read-your-writes continuation point (pass the cursor from the 202 place-order response verbatim). While the projection has not caught up this query returns 404, indistinguishable from "the resource does not exist" — poll with the same cursor.
Example"c1:mkt-0001:184"

Response

200Best prices on both sides

marketstring
Market id
Example"mkt-0001"
yesBidE4integernullable
Best YES bid; null when that side has no resting orders
Example5200
yesAskE4integernullable
Best YES ask; null when that side has no resting orders
Example5300
noBidE4integernullable
Best NO bid (= 10000 − yesAsk)
Example4700
noAskE4integernullable
Best NO ask (= 10000 − yesBid)
Example4800
spreadE4integernullable
Bid-ask spread on the YES side
Example100

Switch status codes in the response example to view errors. For all codes, see the Errors page.