Skip to main content
GET
/
margin
/
markets
/
{ticker}
/
candlesticks
Get Market Candlesticks
curl --request GET \
  --url https://external-api.kalshi.com/trade-api/v2/margin/markets/{ticker}/candlesticks
{
  "ticker": "<string>",
  "candlesticks": [
    {
      "end_period_ts": 123,
      "bid": {
        "open": "0.5600",
        "low": "0.5600",
        "high": "0.5600",
        "close": "0.5600"
      },
      "ask": {
        "open": "0.5600",
        "low": "0.5600",
        "high": "0.5600",
        "close": "0.5600"
      },
      "price": {
        "open": "0.5600",
        "low": "0.5600",
        "high": "0.5600",
        "close": "0.5600",
        "mean": "0.5600",
        "previous": "0.5600"
      },
      "volume": "10.00",
      "open_interest": "10.00"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.kalshi.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
ticker
string
required

Ticker of the margin market

Query Parameters

​
start_ts
integer<int64>
required

Start timestamp (Unix timestamp). Candlesticks will include those ending on or after this time.

​
end_ts
integer<int64>
required

End timestamp (Unix timestamp). Candlesticks will include those ending on or before this time.

​
period_interval
enum<integer>
required

Time period length of each candlestick in minutes. Valid values are 1 (1 minute), 60 (1 hour), or 1440 (1 day).

Available options:
1,
60,
1440
​
include_latest_before_start
boolean
default:false

If true, prepends the latest candlestick available before the start_ts. This synthetic candlestick is created by:

  1. Finding the most recent real candlestick before start_ts
  2. Projecting it forward to the first period boundary (calculated as the next period interval after start_ts)
  3. Setting all OHLC prices to null, and price.previous to the close price from the real candlestick

Response

Candlesticks retrieved successfully

​
ticker
string
required

Unique identifier for the margin market.

​
candlesticks
object[]
required

Array of candlestick data points for the specified time range.