Skip to main content
All URIs are relative to https://api.elections.kalshi.com/trade-api/v2
MethodHTTP requestDescription
getExchangeAnnouncementsGET /exchange/announcementsGet Exchange Announcements
getExchangeScheduleGET /exchange/scheduleGet Exchange Schedule
getExchangeStatusGET /exchange/statusGet Exchange Status
getSeriesFeeChangesGET /series/fee_changesGet Series Fee Changes
getUserDataTimestampGET /exchange/user_data_timestampGet User Data Timestamp

getExchangeAnnouncements

GetExchangeAnnouncementsResponse getExchangeAnnouncements()
Endpoint for getting all exchange-wide announcements.

Parameters

This endpoint does not have any parameters.

Return type

GetExchangeAnnouncementsResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Exchange announcements retrieved successfully-
500Internal server error-

getExchangeSchedule

GetExchangeScheduleResponse getExchangeSchedule()
Endpoint for getting the exchange schedule.

Parameters

This endpoint does not have any parameters.

Return type

GetExchangeScheduleResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Exchange schedule retrieved successfully-
500Internal server error-

getExchangeStatus

ExchangeStatus getExchangeStatus()
Endpoint for getting the exchange status.

Parameters

This endpoint does not have any parameters.

Return type

ExchangeStatus

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Exchange status retrieved successfully-
500Internal server error-
503Service unavailable-
504Gateway timeout-

getSeriesFeeChanges

GetSeriesFeeChangesResponse getSeriesFeeChanges()

Parameters

NameTypeDescriptionNotes
seriesTicker[string](optional) defaults to undefined
showHistorical[boolean](optional) defaults to false

Return type

GetSeriesFeeChangesResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200Series fee changes retrieved successfully-
400Bad request - invalid input-
500Internal server error-

getUserDataTimestamp

GetUserDataTimestampResponse getUserDataTimestamp()
There is typically a short delay before exchange events are reflected in the API endpoints. Whenever possible, combine API responses to PUT/POST/DELETE requests with websocket data to obtain the most accurate view of the exchange state. This endpoint provides an approximate indication of when the data from the following endpoints was last validated: GetBalance, GetOrder(s), GetFills, GetPositions

Parameters

This endpoint does not have any parameters.

Return type

GetUserDataTimestampResponse

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

HTTP response details

Status codeDescriptionResponse headers
200User data timestamp retrieved successfully-
500Internal server error-