Kalshi API endpoint
Returns one Kalshi event by `event_ticker` (such as `KXELONMARS-99`) together with its markets. The event has its series ticker, title, subtitle, category, strike period and mutually-exclusive flag; each market has prices, bid and ask, volume, open interest, status and rules. An unknown ticker returns a not-found error.
/kalshi/event/{event_ticker}Path parameters:
event_ticker: required Kalshi event ticker, for example KXELONMARS-99.Query parameters: none.
Notable response behavior:
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| ticker | 1 | “KXELONMARS-99” |
| event_ticker | 1 | “KXELONMARS-99” |
| title | 1 | “Will Elon Musk visit Mars before Aug 1, 2099?” |
| sub_title | 1 | “Mars” |
| status | 1 | “active” |
| market_type | 1 | “binary” |
| open_time | 1 | 2025-08-28 |
| close_time | 1 | 2099-08-01 |
| expiration_time | 1 | 2099-08-08 |
| last_price | 1 | 0.09 |
| previous_price | 1 | 0.1 |
| yes_bid | 1 | 0.09 |
| yes_ask | 1 | 0.11 |
| no_bid | 1 | 0.89 |
| no_ask | 1 | 0.91 |
| volume | 1 | 120,728.91 |
| volume_24h | 1 | 4.36 |
| open_interest | 1 | 40,116.54 |
| rules_primary | 1 | median 105 characters |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| event_ticker (path) | string | Yes | Kalshi event ticker | KXELONMARS-99 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/kalshi/event/KXELONMARS-99" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"event": {
"event_ticker": "KXELONMARS-99",
"series_ticker": "KXELONMARS",
"title": "Will Elon Musk visit Mars in his lifetime?",
"sub_title": "Before 2099",
"category": "World"
},
"markets": [
{
"ticker": "KXELONMARS-99",
"event_ticker": "KXELONMARS-99",
"title": "Will Elon Musk visit Mars before Aug 1, 2099?",
"status": "active",
"last_price": 0.08
}
],
"source_url": "https://external-api.kalshi.com/trade-api/v2/events/KXELONMARS-99",
"fetched_at": "2026-06-07T14:00:00Z"
}
}Request schema
No body schema
Response schema
#/definitions/kalshi.eventResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | kalshi.EventResponse | No | ||||
| data.event | object | No | The Kalshi event that was requested. | |||
| data.event.available_on_brokers | boolean | No | false | Whether the event's markets can be traded through Kalshi's broker partners. | ||
| data.event.category | string | No | World | Kalshi category of the event, such as `World`. | ||
| data.event.collateral_return_type | string | No | MECNET | Collateral return type Kalshi assigns to the event, such as `MECNET`. | ||
| data.event.event_ticker | string | No | KXELONMARS-99 | Kalshi ticker that identifies the event. | ||
| data.event.last_updated | string | No | 2026-05-10T00:33:53Z | Time the event was last updated, in UTC (RFC 3339). | ||
| data.event.markets | array | No | Markets that belong to the event. Omitted when the response does not include them. | |||
| data.event.markets[].close_time | string | No | 2099-08-01T04:59:00Z | Time trading closes, in UTC (RFC 3339). | ||
| data.event.markets[].event_ticker | string | No | KXELONMARS-99 | Ticker of the event the market belongs to. | ||
| data.event.markets[].expiration_time | string | No | 2099-08-08T15:00:00Z | Time the market expires, in UTC (RFC 3339). | ||
| data.event.markets[].last_price | number | No | 0.08 | Price of the most recent trade, in US dollars per contract. | ||
| data.event.markets[].liquidity | number | No | 0 | Market liquidity, in US dollars. | ||
| data.event.markets[].market_type | string | No | binary | Market type, such as `binary`. | ||
| data.event.markets[].no_ask | number | No | 0.92 | Lowest price asked for a No contract, in US dollars. | ||
| data.event.markets[].no_bid | number | No | 0.9 | Highest price offered for a No contract, in US dollars. | ||
| data.event.markets[].open_interest | number | No | 32773.57 | Number of contracts currently open in the market. | ||
| data.event.markets[].open_time | string | No | 2025-08-28T20:45:00Z | Time trading opened, in UTC (RFC 3339). | ||
| data.event.markets[].previous_price | number | No | 0.1 | Earlier reference price of the market, in US dollars per contract. | ||
| data.event.markets[].response_price_unit | string | No | usd_cent | Price unit label Kalshi attaches to the market, such as `usd_cent`. | ||
| data.event.markets[].result | string | No | Outcome the market settled on. Empty or omitted until it settles. | |||
| data.event.markets[].rules_primary | string | No | Primary rules text that governs how the market settles. | |||
| data.event.markets[].status | string | No | active | Market status as Kalshi reports it, such as `active`. | ||
| data.event.markets[].sub_title | string | No | Mars | Short label of the outcome the market covers, shown under the title. | ||
| data.event.markets[].ticker | string | No | KXELONMARS-99 | Kalshi ticker that identifies the market. | ||
| data.event.markets[].title | string | No | Will Elon Musk visit Mars before Aug 1, 2099? | Market title as shown on Kalshi. | ||
| data.event.markets[].volume | number | No | 94840.88 | Total number of contracts traded in the market. | ||
| data.event.markets[].volume_24h | number | No | 16 | Number of contracts traded in the last 24 hours. | ||
| data.event.markets[].yes_ask | number | No | 0.1 | Lowest price asked for a Yes contract, in US dollars. | ||
| data.event.markets[].yes_bid | number | No | 0.08 | Highest price offered for a Yes contract, in US dollars. | ||
| data.event.mutually_exclusive | boolean | No | false | Whether at most one market in the event can resolve to Yes. | ||
| data.event.series_ticker | string | No | KXELONMARS | Ticker of the series the event belongs to. | ||
| data.event.strike_period | string | No | Strike period of the event, as Kalshi labels it. | |||
| data.event.sub_title | string | No | Before 2099 | Short qualifier shown under the event title, such as a date or deadline. | ||
| data.event.title | string | No | Will Elon Musk visit Mars in his lifetime? | Event title as shown on Kalshi. | ||
| data.fetched_at | string | No | 2026-06-07T14:00:00Z | Time the data was fetched, in UTC (RFC 3339). | ||
| data.markets | array | No | Markets that belong to the event. | |||
| data.markets[].close_time | string | No | 2099-08-01T04:59:00Z | Time trading closes, in UTC (RFC 3339). | ||
| data.markets[].event_ticker | string | No | KXELONMARS-99 | Ticker of the event the market belongs to. | ||
| data.markets[].expiration_time | string | No | 2099-08-08T15:00:00Z | Time the market expires, in UTC (RFC 3339). | ||
| data.markets[].last_price | number | No | 0.08 | Price of the most recent trade, in US dollars per contract. | ||
| data.markets[].liquidity | number | No | 0 | Market liquidity, in US dollars. | ||
| data.markets[].market_type | string | No | binary | Market type, such as `binary`. | ||
| data.markets[].no_ask | number | No | 0.92 | Lowest price asked for a No contract, in US dollars. | ||
| data.markets[].no_bid | number | No | 0.9 | Highest price offered for a No contract, in US dollars. | ||
| data.markets[].open_interest | number | No | 32773.57 | Number of contracts currently open in the market. | ||
| data.markets[].open_time | string | No | 2025-08-28T20:45:00Z | Time trading opened, in UTC (RFC 3339). | ||
| data.markets[].previous_price | number | No | 0.1 | Earlier reference price of the market, in US dollars per contract. | ||
| data.markets[].response_price_unit | string | No | usd_cent | Price unit label Kalshi attaches to the market, such as `usd_cent`. | ||
| data.markets[].result | string | No | Outcome the market settled on. Empty or omitted until it settles. | |||
| data.markets[].rules_primary | string | No | Primary rules text that governs how the market settles. | |||
| data.markets[].status | string | No | active | Market status as Kalshi reports it, such as `active`. | ||
| data.markets[].sub_title | string | No | Mars | Short label of the outcome the market covers, shown under the title. | ||
| data.markets[].ticker | string | No | KXELONMARS-99 | Kalshi ticker that identifies the market. | ||
| data.markets[].title | string | No | Will Elon Musk visit Mars before Aug 1, 2099? | Market title as shown on Kalshi. | ||
| data.markets[].volume | number | No | 94840.88 | Total number of contracts traded in the market. | ||
| data.markets[].volume_24h | number | No | 16 | Number of contracts traded in the last 24 hours. | ||
| data.markets[].yes_ask | number | No | 0.1 | Lowest price asked for a Yes contract, in US dollars. | ||
| data.markets[].yes_bid | number | No | 0.08 | Highest price offered for a Yes contract, in US dollars. | ||
| data.source_url | string | No | https://external-api.kalshi.com/trade-api/v2/events/KXELONMARS-99 | URL the data was read from. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/kalshi/event/KXELONMARS-99" \
-H "x-api-key: $CRAWLORA_API_KEY"