Skip to main content
GET
/
polymarket
/
candlesticks
/
{condition_id}
Get Candlesticks
curl --request GET \
  --url https://api.domeapi.io/v1/polymarket/candlesticks/{condition_id}
{
  "candlesticks": [
    [
      [
        {
          "end_period_ts": 1727827200,
          "open_interest": 8456498,
          "price": {
            "open": 0,
            "high": 0,
            "low": 0,
            "close": 0,
            "open_dollars": "0.0049",
            "high_dollars": "0.0049",
            "low_dollars": "0.0048",
            "close_dollars": "0.0048",
            "mean": 0,
            "mean_dollars": "0.0049",
            "previous": 0,
            "previous_dollars": "0.0049"
          },
          "volume": 8456498,
          "yes_ask": {
            "open": 0.00489,
            "close": 0.0048200000000000005,
            "high": 0.00491,
            "low": 0.0048,
            "open_dollars": "0.0049",
            "close_dollars": "0.0048",
            "high_dollars": "0.0049",
            "low_dollars": "0.0048"
          },
          "yes_bid": {
            "open": 0.00489,
            "close": 0.004829999990880811,
            "high": 0.004910000000138527,
            "low": 0.0048,
            "open_dollars": "0.0049",
            "close_dollars": "0.0048",
            "high_dollars": "0.0049",
            "low_dollars": "0.0048"
          }
        }
      ],
      {
        "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455"
      }
    ]
  ]
}

Path Parameters

​
condition_id
string
required

Query Parameters

​
start_time
integer
required

Unix timestamp (in seconds) for start of time range

Example:

1640995200

​
end_time
integer
required

Unix timestamp (in seconds) for end of time range

Example:

1672531200

​
interval
enum<integer>
default:1

Interval length: 1 = 1m, 60 = 1h, 1440 = 1d. Defaults to 1m.

⚠️ Note: There are range limits for interval — specifically:

  • 1 (1m): max range 1 week
  • 60 (1h): max range 1 month
  • 1440 (1d): max range 1 year
Available options:
1,
60,
1440

Response

Candlestick response

​
candlesticks
((object[] | object)[])[]

Array of market candlestick data, where each element is a tuple containing candlestick data array and token metadata

Tuple of [candlestick_data_array, token_metadata]

Required array length: 2 elements
  • object[]
  • object
Example:
[
  [
    {
      "end_period_ts": 1727827200,
      "open_interest": 8456498,
      "price": {
        "open": 0,
        "high": 0,
        "low": 0,
        "close": 0,
        "open_dollars": "0.0049",
        "high_dollars": "0.0049",
        "low_dollars": "0.0048",
        "close_dollars": "0.0048",
        "mean": 0,
        "mean_dollars": "0.0049",
        "previous": 0,
        "previous_dollars": "0.0049"
      },
      "volume": 8456498,
      "yes_ask": {
        "open": 0.00489,
        "close": 0.0048200000000000005,
        "high": 0.00491,
        "low": 0.0048,
        "open_dollars": "0.0049",
        "close_dollars": "0.0048",
        "high_dollars": "0.0049",
        "low_dollars": "0.0048"
      },
      "yes_bid": {
        "open": 0.00489,
        "close": 0.004829999990880811,
        "high": 0.004910000000138527,
        "low": 0.0048,
        "open_dollars": "0.0049",
        "close_dollars": "0.0048",
        "high_dollars": "0.0049",
        "low_dollars": "0.0048"
      }
    }
  ],
  {
    "token_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455"
  }
]