Skip to main content
GET
/
polymarket
/
candlesticks
Get Candlesticks
curl --request GET \
  --url https://api.aisa.one/apis/v1/polymarket/candlesticks \
  --header 'Authorization: Bearer <token>'
{
  "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",
        "side": "Yes"
      }
    ]
  ]
}
Fetches historical OHLC (open, high, low, close) candlestick data for a Polymarket market identified by its condition_id. Data is returned over a specified time range at configurable intervals (1-minute, 1-hour, or 1-day). Each candlestick includes price data, volume, open interest, and bid/ask spreads. Best for: Building price charts, technical analysis, tracking market volatility, visualizing price movements over time. Endpoint: GET /polymarket/candlesticks — condition_id is a query parameter, not a path parameter.
Note: There are range limits per interval: 1-minute intervals support a maximum range of 1 week, 1-hour intervals support 1 month, and 1-day intervals support 1 year.

​
Example

curl -X GET "https://api.aisa.one/apis/v1/polymarket/candlesticks?condition_id=0x1234abcd5678ef90&start_time=1640995200&end_time=1672531200&interval=1440" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
Response

The response returns a candlesticks array where each element is a tuple of a candlestick data array and token metadata. Each candlestick data object contains OHLC prices (in both raw and dollar values), volume, open interest, and yes-side bid/ask spreads. The token metadata includes the token ID and outcome label (e.g., “Yes”, “No”).

Authorizations

​
Authorization
string
header
required

Your AIsa API key as a Bearer token.

Path Parameters

​
condition_id
string
required

Query Parameters

​
condition_id
string
required

Polymarket condition ID for the market.

​
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
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",
    "side": "Yes"
  }
]