Skip to main content
GET
/
getMentionMarket
Get Mention Market
curl --request GET \
  --url https://us-central1-mentionmarket-dddf0.cloudfunctions.net/getMentionMarket
{
  "market_ticker": "<string>",
  "series_ticker": "<string>",
  "title": "<string>",
  "strike_word": "<string>",
  "close_time": "<string>",
  "created_time": "<string>",
  "event_ticker": "<string>",
  "expected_expiration_time": "<string>",
  "expiration_time": "<string>",
  "last_price": 123,
  "liquidity": 123,
  "no_ask_dollars": 123,
  "no_bid_dollars": 123,
  "yes_ask_dollars": 123,
  "yes_bid_dollars": 123,
  "open_interest": 123,
  "open_time": "<string>",
  "volume": 123,
  "volume_24h": 123,
  "result": "<string>",
  "previous_yes_bid_dollars": 123,
  "previous_yes_ask_dollars": 123,
  "previous_no_bid_dollars": 123,
  "previous_no_ask_dollars": 123,
  "rules_primary": "<string>",
  "settlement_ts": "<string>",
  "scheduledStartTime": "<string>",
  "event_subtitle": "<string>",
  "error": "<string>",
  "message": "<string>"
}

​
Query Parameters

​
market_ticker
string
required
The market ticker to retrieve information for (e.g., “KXNFLMENTION-26JAN17BUFDEN-TUSH”)

​
Response

Returns a simplified market object with only the relevant fields:
​
market_ticker
string
The market ticker symbol
​
series_ticker
string
The series ticker extracted from the event_ticker (string before first dash, e.g., “KXNFLMENTION”)
​
title
string
The market title/question
​
strike_word
string
The strike word extracted from custom_strike.Word field
​
close_time
string
Market close time (ISO 8601 format)
​
created_time
string
Market creation time (ISO 8601 format)
​
event_ticker
string
The event ticker associated with this market
​
expected_expiration_time
string
Expected expiration time (ISO 8601 format)
​
expiration_time
string
Actual expiration time (ISO 8601 format)
​
last_price
number
Last traded price (in cents)
​
liquidity
number
Market liquidity
​
no_ask_dollars
number
No side ask price in dollars
​
no_bid_dollars
number
No side bid price in dollars
​
yes_ask_dollars
number
Yes side ask price in dollars
​
yes_bid_dollars
number
Yes side bid price in dollars
​
open_interest
number
Total open interest
​
open_time
string
Market open time (ISO 8601 format)
​
volume
number
Total trading volume
​
volume_24h
number
24-hour trading volume
​
result
string
Market result (“yes”, “no”, or null if not settled)
​
previous_yes_bid_dollars
number
Previous yes bid price in dollars
​
previous_yes_ask_dollars
number
Previous yes ask price in dollars
​
previous_no_bid_dollars
number
Previous no bid price in dollars
​
previous_no_ask_dollars
number
Previous no ask price in dollars
​
rules_primary
string
Primary rules text for the market
​
settlement_ts
string
Settlement timestamp (ISO 8601 format)
​
scheduledStartTime
string
Scheduled start time for the event (ISO 8601 format). Fetched from Firestore or Kalshi API.
​
event_subtitle
string
Subtitle of the associated event. Fetched from Firestore or Kalshi API.

​
Example Request

curl "https://us-central1-mentionmarket-dddf0.cloudfunctions.net/getMentionMarket?market_ticker=KXNFLMENTION-26JAN17BUFDEN-TUSH"

​
Example Response

{
  "market_ticker": "KXNFLMENTION-26JAN17BUFDEN-TUSH",
  "series_ticker": "KXNFLMENTION",
  "title": "Will 'Tush Push' be mentioned in Buffalo at New England on January 17th?",
  "strike_word": "Tush Push",
  "close_time": "2026-01-17T23:59:59Z",
  "created_time": "2026-01-10T00:00:00Z",
  "event_ticker": "KXNFLMENTION-26JAN17BUFDEN",
  "expected_expiration_time": "2026-01-17T23:59:59Z",
  "expiration_time": null,
  "last_price": 55,
  "liquidity": 10000,
  "no_ask_dollars": 0.45,
  "no_bid_dollars": 0.44,
  "yes_ask_dollars": 0.56,
  "yes_bid_dollars": 0.55,
  "open_interest": 5000,
  "open_time": "2026-01-10T12:00:00Z",
  "volume": 25000,
  "volume_24h": 5000,
  "result": null,
  "previous_yes_bid_dollars": 0.54,
  "previous_yes_ask_dollars": 0.55,
  "previous_no_bid_dollars": 0.45,
  "previous_no_ask_dollars": 0.46,
  "rules_primary": "If Tush Push is mentioned in the Buffalo at New England game on January 17th, 2026.",
  "settlement_ts": null,
  "scheduledStartTime": "2026-01-17T13:00:00Z",
  "event_subtitle": "Buffalo at New England"
}

​
Error Responses

​
error
string
Error message describing what went wrong
​
message
string
Additional error details

​
400 Bad Request

{
  "error": "Missing required parameter: market_ticker"
}

​
404 Not Found

{
  "error": "Market not found"
}

​
500 Internal Server Error

{
  "error": "Failed to fetch mention market",
  "message": "Kalshi API Error: 500 Internal Server Error"
}

​
Notes

The endpoint optimizes performance by first checking Firestore for scheduledStartTime and event_subtitle. If not found in Firestore, it fetches from the Kalshi API.
The series_ticker is automatically extracted from the event_ticker by taking the part before the first dash. For example, “KXNFLMENTION-26JAN17BUFDEN” becomes “KXNFLMENTION”.
This endpoint wraps the Kalshi Get Market API. Rate limits and availability depend on Kalshi’s API limits.