Docs menu

Kalshi API endpoint

Kalshi Event Metadata API

Returns the media and market metadata for one Kalshi event by `event_ticker`. The response has the event image and featured image, a color code and image for each market, settlement sources with name and URL, and competition context when it applies. An unknown ticker returns a not-found error.

GETapiKey2 credits/requestKalshikalshi.eventMetadataResponseDoc/kalshi/event/{event_ticker}/metadata

Endpoint facts

Method: GET
API path: /kalshi/event/{event_ticker}/metadata
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Kalshi
Response schema: #/definitions/kalshi.eventMetadataResponseDoc

Kalshi Scraper API Try Kalshi Event Metadata API in Playground Kalshi API documentation

How this endpoint behaves

Returns Kalshi event media, market-detail, and settlement-source metadata.

Path parameters:

event_ticker: required Kalshi event ticker, for example KXELONMARS-99.

Query parameters: none.

Notable response behavior:

Invalid or empty event tickers return invalid-parameter errors before upstream IO.
Missing upstream event metadata returns not-found errors.

Live monitoring

Monitored request: GET /kalshi/event/KXELONMARS-99/metadata
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.20 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /kalshi/event/KXELONMARS-99/metadata
Items in settlement_sources: 17
Fields filled in every checked item: 2

Field	Filled in, of 17 checked	Values in the sample
name	17	median 15 characters
url	17	theguardian.com and 12 other hosts

Request parameters

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 example

curl -X GET "https://api.crawlora.net/api/v1/kalshi/event/KXELONMARS-99/metadata" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_ticker": "KXELONMARS-99",
    "image_url": "https://kalshi-public-docs.s3.amazonaws.com/series-images-webp/KXELONMARS.webp",
    "market_details": [
      {
        "market_ticker": "KXELONMARS-99",
        "color_code": "#AA00FF"
      }
    ],
    "settlement_sources": [
      {
        "name": "The Guardian",
        "url": "https://www.theguardian.com"
      }
    ],
    "source_url": "https://external-api.kalshi.com/trade-api/v2/events/KXELONMARS-99/metadata",
    "fetched_at": "2026-06-07T14:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/kalshi.eventMetadataResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	kalshi.EventMetadataResponse	No
data.competition	object	No		Competition the event is part of. Omitted when the event has none.
data.competition.id	string	No		Kalshi identifier of the competition.
data.competition.name	string	No		Name of the competition.
data.competition_scope	string	No		Scope of the competition the event is part of, as Kalshi labels it.
data.event_ticker	string	No	KXELONMARS-99	Ticker of the Kalshi event the metadata belongs to.
data.featured_image_url	string	No		URL of the event's featured image.
data.fetched_at	string	No	2026-06-07T14:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.image_url	string	No	https://kalshi-public-docs.s3.amazonaws.com/series-images-webp/KXELONMARS.webp	URL of the event's image.
data.market_details	array	No		Display details for each market in the event.
data.market_details[].color_code	string	No	#AA00FF	Display colour of the market on Kalshi, as a hex code.
data.market_details[].image_url	string	No		URL of the market's image.
data.market_details[].market_ticker	string	No	KXELONMARS-99	Ticker of the market the details belong to.
data.settlement_sources	array	No		Sources Kalshi uses to settle the event's markets.
data.settlement_sources[].name	string	No	The Guardian	Name of the source used to settle markets, such as `The Guardian`.
data.settlement_sources[].url	string	No	https://www.theguardian.com	Link to the settlement source's website.
data.source_url	string	No	https://external-api.kalshi.com/trade-api/v2/events/KXELONMARS-99/metadata	URL the data was read from.
msg	string	No	OK

Failure responses

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

Code examples

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/metadata" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Kalshi endpoint docs Kalshi Scraper API Kalshi Event API documentation Kalshi Event History API documentation Kalshi Events API documentation Kalshi Multivariate Events API documentation Kalshi Exchange Schedule API documentation Kalshi Exchange Status API documentation

Open in Playground Back to group

Docs menu

Kalshi API endpoint

Kalshi Event Metadata API

GETapiKey2 credits/requestKalshikalshi.eventMetadataResponseDoc/kalshi/event/{event_ticker}/metadata

Endpoint facts

Method: GET
API path: /kalshi/event/{event_ticker}/metadata
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Kalshi
Response schema: #/definitions/kalshi.eventMetadataResponseDoc

Kalshi Scraper API Try Kalshi Event Metadata API in Playground Kalshi API documentation

How this endpoint behaves

Returns Kalshi event media, market-detail, and settlement-source metadata.

Path parameters:

event_ticker: required Kalshi event ticker, for example KXELONMARS-99.

Query parameters: none.

Notable response behavior:

Invalid or empty event tickers return invalid-parameter errors before upstream IO.
Missing upstream event metadata returns not-found errors.

Live monitoring

Monitored request: GET /kalshi/event/KXELONMARS-99/metadata
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 0.20 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /kalshi/event/KXELONMARS-99/metadata
Items in settlement_sources: 17
Fields filled in every checked item: 2

Field	Filled in, of 17 checked	Values in the sample
name	17	median 15 characters
url	17	theguardian.com and 12 other hosts

Request parameters

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 example

curl -X GET "https://api.crawlora.net/api/v1/kalshi/event/KXELONMARS-99/metadata" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_ticker": "KXELONMARS-99",
    "image_url": "https://kalshi-public-docs.s3.amazonaws.com/series-images-webp/KXELONMARS.webp",
    "market_details": [
      {
        "market_ticker": "KXELONMARS-99",
        "color_code": "#AA00FF"
      }
    ],
    "settlement_sources": [
      {
        "name": "The Guardian",
        "url": "https://www.theguardian.com"
      }
    ],
    "source_url": "https://external-api.kalshi.com/trade-api/v2/events/KXELONMARS-99/metadata",
    "fetched_at": "2026-06-07T14:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/kalshi.eventMetadataResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	kalshi.EventMetadataResponse	No
data.competition	object	No		Competition the event is part of. Omitted when the event has none.
data.competition.id	string	No		Kalshi identifier of the competition.
data.competition.name	string	No		Name of the competition.
data.competition_scope	string	No		Scope of the competition the event is part of, as Kalshi labels it.
data.event_ticker	string	No	KXELONMARS-99	Ticker of the Kalshi event the metadata belongs to.
data.featured_image_url	string	No		URL of the event's featured image.
data.fetched_at	string	No	2026-06-07T14:00:00Z	Time the data was fetched, in UTC (RFC 3339).
data.image_url	string	No	https://kalshi-public-docs.s3.amazonaws.com/series-images-webp/KXELONMARS.webp	URL of the event's image.
data.market_details	array	No		Display details for each market in the event.
data.market_details[].color_code	string	No	#AA00FF	Display colour of the market on Kalshi, as a hex code.
data.market_details[].image_url	string	No		URL of the market's image.
data.market_details[].market_ticker	string	No	KXELONMARS-99	Ticker of the market the details belong to.
data.settlement_sources	array	No		Sources Kalshi uses to settle the event's markets.
data.settlement_sources[].name	string	No	The Guardian	Name of the source used to settle markets, such as `The Guardian`.
data.settlement_sources[].url	string	No	https://www.theguardian.com	Link to the settlement source's website.
data.source_url	string	No	https://external-api.kalshi.com/trade-api/v2/events/KXELONMARS-99/metadata	URL the data was read from.
msg	string	No	OK

Failure responses

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

Code examples

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/metadata" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Kalshi Event Metadata API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Kalshi Event Metadata API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related