API Reference

List Updown Intervals

Get updown markets organized by interval with rotation timing metadata. Designed for trading bots that need to: 1. Know which markets are currently active per interval 2. See how much time remains before the current interval expires 3. Discover the next interval's markets to rotate into Returns a dict keyed by interval with: - current: list of active markets for this interval (end_date in the future) - seconds_until_rotation: seconds until the soonest market in this interval expires - next_rotation_at: ISO timestamp of when the soonest market expires - asset_markets: nested {asset: [markets]} for quick lookup - crypto_prices: reference spot prices for the assets in the response Crypto Up/Down markets exist at three intervals only — **5m, 15m and 4h**. (An earlier version of this description advertised "1H, 4H, daily"; a census of the full 2.09M-market universe found zero markets at a 1h or daily crypto interval, and none have ever existed.) **`crypto_prices` is a SPOT price and is not the settlement reference.** From 2026-08-07 Polymarket resolves crypto Up/Down markets on a Chainlink time-weighted average price — a 30-second window for 5m markets, 60 seconds for 15m and 4h. Measured against our own archived Chainlink series, the spot price implies a different outcome than the TWAP in roughly 5% of 5-minute rounds, concentrated almost entirely in markets finishing within a couple of basis points of the price-to-beat. Do not derive a settlement expectation from this field; read the resolved outcome instead.

GET

markets

updown

intervals

List Updown Intervals

curl --request GET \
  --url https://api.polysimulator.com/v1/markets/updown/intervals

const options = {method: 'GET'};

fetch('https://api.polysimulator.com/v1/markets/updown/intervals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polysimulator.com/v1/markets/updown/intervals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polysimulator.com/v1/markets/updown/intervals"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polysimulator.com/v1/markets/updown/intervals")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "intervals": {},
  "available_intervals": [
    "<string>"
  ],
  "total_markets": 123,
  "crypto_prices": {},
  "timestamp": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {},
  "request_id": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {},
  "request_id": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {},
  "request_id": "<string>"
}

Headers

X-API-Key

string | null

Your PolySimulator API key

POLY_API_KEY

string | null

Polymarket-CLOB-compat alias for X-API-Key (underscore form). SDK clients ported from Polymarket can authenticate without changing header names. X-API-Key takes precedence when both are provided.

Poly-API-Key

string | null

PM-CLOB-compat dashed-form alias for X-API-Key. Same value semantics as POLY_API_KEY but with HTTP-conventional dash separators. Both spellings are accepted end-to-end.

authorization

string | null

PM-CLOB-compat: Authorization: Bearer ps_live_... (or ps_test_...) is accepted as an alias for X-API-Key so py-clob-client and other ported SDKs authenticate without header name changes. Bearer JWTs are NOT accepted here — use the dashboard-auth endpoints for those.

Query Parameters

asset

string | null

Filter by asset symbol, e.g. BTC, ETH, SOL, XRP, BNB, DOGE, HYPE for the crypto intervals. Case-insensitive.

limit

integer

default:100

Maximum markets returned PER INTERVAL, newest first. The response used to be unbounded and served 13.2 MB; a bot that wants one asset's current interval no longer has to download the catalogue to find it. Raise it if you genuinely need more.

Required range: 1 <= x <= 1000

group_by_asset

boolean

default:false

Also return asset_markets, the same markets re-keyed by asset. OFF by default because it is a duplicate: measured 2026-09-05 it held byte-for-byte the same market set as current (2,296 of 2,296 condition_ids in the 5M interval), which is where half of the old 13.2 MB went.

Response

Successful Response

intervals

object

available_intervals

string[]

total_markets

integer

crypto_prices

object

timestamp

string

List Updown Intervals

curl --request GET \
  --url https://api.polysimulator.com/v1/markets/updown/intervals

const options = {method: 'GET'};

fetch('https://api.polysimulator.com/v1/markets/updown/intervals', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.polysimulator.com/v1/markets/updown/intervals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polysimulator.com/v1/markets/updown/intervals"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polysimulator.com/v1/markets/updown/intervals")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "intervals": {},
  "available_intervals": [
    "<string>"
  ],
  "total_markets": 123,
  "crypto_prices": {},
  "timestamp": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {},
  "request_id": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {},
  "request_id": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {},
  "request_id": "<string>"
}

Overview

Endpoints

List Updown Intervals

Headers

Query Parameters

Response