Skip to main content

Up/Down Markets

Both /markets/updown and /v1/markets/updown work — they return the identical payload. The /v1/markets/updown alias is not listed in the OpenAPI schema, but it is a live, fully-functional route, so you can keep your /v1/... base path everywhere. The companion interval-discovery endpoint GET /v1/markets/updown/intervals is a regular versioned route.
Returns active up/down interval markets — short-term binary markets that resolve based on whether an asset’s price goes up or down within a specific time window.

Query Parameters

5M and 15M are subject to availability — see GET /v1/markets/updown/intervals to discover which intervals are currently active.

Request

The un-versioned https://api.polysimulator.com/markets/updown form works identically if your existing code already uses it — same handler, same response.

Response

markets is the canonical market list. Group it client-side by each entry’s asset and interval fields; the API does not duplicate full market objects into precomputed grouping trees.

Market Entry Fields


Trading Up/Down Markets

Up/down markets trade like any other market through POST /v1/orders. The part bots get wrong is picking the round: the list holds the current round and upcoming ones, so select by time rather than taking markets[0], and trade the nested markets[0].condition_id.
Prices from /book and order responses are strings (see String Numerics); live_price.buy / sell on this endpoint are floats and are a display summary, not a quote. Price a bot off the book.
With the SDK the same steps are client.list_updown(asset="BTC", interval="5M"), client.get_book(cid, outcome="Up") and client.place_order(...). A ported py-clob-client bot can keep get_order_book(token_id) and create_order / post_order against token_ids[outcomes.index("Up")] (see CLOB compatibility).
Up/down markets have short lifespans (5 minutes to 24 hours). After expiry, prices may show invalid values (both outcomes at 100%). The API blocks BUY orders on expired markets but allows SELL orders for emergency position exit.

Next Steps