{"openapi":"3.1.0","info":{"title":"parrot.markets","description":"Transcripts, word history and probabilities for Kalshi and Polymarket mention markets: earnings calls, politics, the Fed, the White House, news, podcasts, sports and more. Agent guide: /llms.txt. MCP: POST /mcp.","version":"0.1.0"},"paths":{"/api/v1/status/health":{"get":{"tags":["api"],"summary":"Compact health: green / amber / red, freshness per category, 5xx rate, Mac worker (<= 2 KB; ?probe=1 answers 503 when red)","description":"GET /api/v1/status/health: the compact snapshot (<= 2 KB), live edge counters folded in.","operationId":"health_endpoint_api_v1_status_health_get","parameters":[{"name":"probe","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Probe"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/upcoming":{"get":{"tags":["api"],"summary":"Occasions with listed mention markets in the next N days, a row each: date, time, entity, venues, listed words, top 3 words (key:rate:n)","operationId":"upcoming_api_v1_upcoming_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hub id (earnings, trump, fed, white-house, news, politics, sports, business, entertainment, podcasts, world); default all","title":"Category"},"description":"Hub id (earnings, trump, fed, white-house, news, politics, sports, business, entertainment, podcasts, world); default all"},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}},{"name":"markets","in":"query","required":false,"schema":{"type":"boolean","description":"Add px (mid price 0-1 of the listing venue; may be delayed). Off by default","default":false,"title":"Markets"},"description":"Add px (mid price 0-1 of the listing venue; may be delayed). Off by default"},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"Also occasions without a market (scheduled appearances, the earnings calendar)","default":false,"title":"All"},"description":"Also occasions without a market (scheduled appearances, the earnings calendar)"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of columns (unknown names are a 400 listing the allowed ones); 'full' gives every column (+ icon on upcoming and entity): date, time, hub, ent, name, app, ev, v, n_w, top3, kind, win, icon, evs","title":"Fields"},"description":"Comma list of columns (unknown names are a 400 listing the allowed ones); 'full' gives every column (+ icon on upcoming and entity): date, time, hub, ent, name, app, ev, v, n_w, top3, kind, win, icon, evs"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/brief":{"get":{"tags":["api"],"summary":"One occasion, a row per listed word ranked by p: settlement history (n y rate l10), transcript history (tn th), p, and after the event cnt / res / t / clip; the rows that fit 3.2 KB, offset= / limit= page the rest","operationId":"brief_api_v1_brief_get","parameters":[{"name":"event","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Event id (k:<KALSHI TICKER> or p:<polymarket slug>); its venue counterparts are merged in","title":"Event"},"description":"Event id (k:<KALSHI TICKER> or p:<polymarket slug>); its venue counterparts are merged in"},{"name":"appearance","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Appearance id or slug","title":"Appearance"},"description":"Appearance id or slug"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias; with date= the occasion nearest it, else the next open one","title":"Entity"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias; with date= the occasion nearest it, else the next open one"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX","title":"Symbol"},"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD (with entity / symbol)","title":"Date"},"description":"Date YYYY-MM-DD (with entity / symbol)"},{"name":"markets","in":"query","required":false,"schema":{"type":"boolean","description":"Add px (mid price 0-1 of the listing venue; may be delayed). Off by default","default":false,"title":"Markets"},"description":"Add px (mid price 0-1 of the listing venue; may be delayed). Off by default"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of columns (unknown names are a 400 listing the allowed ones); 'full' gives every column (+ icon on upcoming and entity): w, key, thr, scope, v, n, y, rate, l10, tn, th, p, p_src, cnt, cnt_all, res, t, clip, px, streak, last_y, ev, strike, ent","title":"Fields"},"description":"Comma list of columns (unknown names are a 400 listing the allowed ones); 'full' gives every column (+ icon on upcoming and entity): w, key, thr, scope, v, n, y, rate, l10, tn, th, p, p_src, cnt, cnt_all, res, t, clip, px, streak, last_y, ev, strike, ent"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":10000,"minimum":0},{"type":"null"}],"description":"Rows (by p) from offset; 0 = every row. Default: as many as fit 3.2 KB; a '# rows ... more: offset=N' line says how many more there are","title":"Limit"},"description":"Rows (by p) from offset; 0 = every row. Default: as many as fit 3.2 KB; a '# rows ... more: offset=N' line says how many more there are"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"description":"First row (the more: offset= of the previous page)","default":0,"title":"Offset"},"description":"First row (the more: offset= of the previous page)"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/word":{"get":{"tags":["api"],"summary":"One word of one entity in one line: settlement history, transcript history, p, scope, next listing","operationId":"word_api_v1_word_get","parameters":[{"name":"word","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too; a word key ('ai|artificial intelligence', 'trump#5') works too","title":"Word"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too; a word key ('ai|artificial intelligence', 'trump#5') works too"},{"name":"key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A word key instead of word= ('ai|artificial intelligence')","title":"Key"},"description":"A word key instead of word= ('ai|artificial intelligence')"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias","title":"Entity"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX","title":"Symbol"},"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX"},{"name":"markets","in":"query","required":false,"schema":{"type":"boolean","description":"Add px (mid price 0-1 of the listing venue; may be delayed). Off by default","default":false,"title":"Markets"},"description":"Add px (mid price 0-1 of the listing venue; may be delayed). Off by default"},{"name":"next","in":"query","required":false,"schema":{"type":"boolean","description":"Answer the next open market that lists the word, even when it is a wider listing ('Russia / Ukraine' for Ukraine); default: the word's own key, with next / next_as naming that market","default":false,"title":"Next"},"description":"Answer the next open market that lists the word, even when it is a wider listing ('Russia / Ukraine' for Ukraine); default: the word's own key, with next / next_as naming that market"},{"name":"format","in":"query","required":false,"schema":{"enum":["text","json"],"type":"string","default":"text","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/quotes":{"get":{"tags":["api"],"summary":"Where a word was said: capped quotes (<= 25 words, match in «»), newest first, counted under the market's scope","operationId":"quotes_api_v1_quotes_get","parameters":[{"name":"word","in":"query","required":true,"schema":{"type":"string","description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too","title":"Word"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias","title":"Entity"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX","title":"Symbol"},"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX"},{"name":"appearance","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"One appearance (id or slug)","title":"Appearance"},"description":"One appearance (id or slug)"},{"name":"call","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earnings: report date YYYY-MM-DD (nearest call within 3 days) or 'last'","title":"Call"},"description":"Earnings: report date YYYY-MM-DD (nearest call within 3 days) or 'last'"},{"name":"call_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":9223372036854775807},{"type":"null"}],"title":"Call Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":0,"description":"Quote rows (at most 5 from sources that are not public domain / OPL; 0 = that maximum)","default":5,"title":"Limit"},"description":"Quote rows (at most 5 from sources that are not public domain / OPL; 0 = that maximum)"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of columns (unknown names are a 400 listing the allowed ones); 'full' gives every column (+ icon on upcoming and entity): app, date, spk, role, sec, t, q, counted, src, text_kind","title":"Fields"},"description":"Comma list of columns (unknown names are a 400 listing the allowed ones); 'full' gives every column (+ icon on upcoming and entity): app, date, spk, role, sec, t, q, counted, src, text_kind"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md","text"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/status":{"get":{"tags":["api"],"summary":"Data freshness, counts, each job's last run, QA rates and gap counts (compact); detail=1 adds job summaries and the gap lists","operationId":"status_api_v1_status_get","parameters":[{"name":"detail","in":"query","required":false,"schema":{"type":"boolean","description":"Add each job's last summary and the gap lists (earnings events without a symbol, capped; companies without transcripts)","default":false,"title":"Detail"},"description":"Add each job's last summary and the gap lists (earnings events without a symbol, capped; companies without transcripts)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/companies":{"get":{"tags":["api"],"summary":"Tracked companies (filter q by symbol / name)","operationId":"companies_api_v1_companies_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/companies/{symbol}":{"get":{"tags":["api"],"summary":"One company: calls, events, speakers, next call date","operationId":"company_api_v1_companies__symbol__get","parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string","title":"Symbol"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/calls":{"get":{"tags":["api"],"summary":"Calls, newest first","operationId":"calls_api_v1_calls_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted","title":"Symbol"},"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD","title":"From"},"description":"Date YYYY-MM-DD"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD","title":"To"},"description":"Date YYYY-MM-DD"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":9223372036854775807,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/calls/{call_id}":{"get":{"tags":["api"],"summary":"One call: speakers, paragraph structure (text withheld: internal rights), events; q marks a word (offsets + capped quotes)","operationId":"call_api_v1_calls__call_id__get","parameters":[{"name":"call_id","in":"path","required":true,"schema":{"type":"integer","maximum":9223372036854775807,"title":"Call Id"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too (marks it)","title":"Q"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too (marks it)"},{"name":"operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator","title":"Operator"},"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator"},{"name":"analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst","title":"Analyst"},"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst"},{"name":"include_operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Operator"}},{"name":"include_analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Analyst"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/search":{"get":{"tags":["api"],"summary":"Transcript search (FTS5 syntax) across every hub: a row per hit (app, date, entity, speaker, section, t, quote, src); group=call gives the earnings-only grouped JSON","operationId":"search_api_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","description":"SQLite FTS5 query: words (ANDed), \"exact phrase\", prefix* (3+ characters), OR, NOT (needs a left side), NEAR(a b, 5)","title":"Q"},"description":"SQLite FTS5 query: words (ANDed), \"exact phrase\", prefix* (3+ characters), OR, NOT (needs a left side), NEAR(a b, 5)"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hub id","title":"Category"},"description":"Hub id"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias","title":"Entity"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted (list allowed; group=call, or an alias of entity=)","title":"Symbol"},"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted (list allowed; group=call, or an alias of entity=)"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD","title":"From"},"description":"Date YYYY-MM-DD"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD","title":"To"},"description":"Date YYYY-MM-DD"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Transcripts (appearances / calls) per page","default":10,"title":"Limit"},"description":"Transcripts (appearances / calls) per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":9223372036854775807,"minimum":0,"default":0,"title":"Offset"}},{"name":"per_app","in":"query","required":false,"schema":{"type":"integer","maximum":5,"minimum":1,"description":"Hits per transcript","default":2,"title":"Per App"},"description":"Hits per transcript"},{"name":"group","in":"query","required":false,"schema":{"anyOf":[{"const":"call","type":"string"},{"type":"null"}],"description":"call: the earnings-only JSON grouped by call (the pre-v3 shape)","title":"Group"},"description":"call: the earnings-only JSON grouped by call (the pre-v3 shape)"},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"enum":["company","analyst","operator"],"type":"string"},{"type":"null"}],"description":"group=call only","title":"Role"},"description":"group=call only"},{"name":"section","in":"query","required":false,"schema":{"anyOf":[{"enum":["prepared","qa"],"type":"string"},{"type":"null"}],"description":"group=call only","title":"Section"},"description":"group=call only"},{"name":"speaker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"group=call only: speaker name substring","title":"Speaker"},"description":"group=call only: speaker name substring"},{"name":"per_call","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"group=call only: snippets per call (capped at 5)","default":5,"title":"Per Call"},"description":"group=call only: snippets per call (capped at 5)"},{"name":"plain","in":"query","required":false,"schema":{"type":"boolean","description":"group=call only: «hit» text instead of HTML <mark>","default":false,"title":"Plain"},"description":"group=call only: «hit» text instead of HTML <mark>"},{"name":"snippet_chars","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":40,"description":"group=call only (capped at 200)","default":160,"title":"Snippet Chars"},"description":"group=call only (capped at 200)"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md","csv"],"type":"string","default":"tsv","title":"Format"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of columns: app, date, ent, spk, sec, t, q, src, text_kind, hub, role (group=call: call_id, symbol, report_date, label, fiscal_year, fiscal_quarter, flags, hits, snippets)","title":"Fields"},"description":"Comma list of columns: app, date, ent, spk, sec, t, q, src, text_kind, hub, role (group=call: call_id, symbol, report_date, label, fiscal_year, fiscal_quarter, flags, hits, snippets)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/count":{"get":{"tags":["api"],"summary":"A word's per-call counts over a company's last n calls","operationId":"count_api_v1_count_get","parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted","title":"Symbol"},"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted"},{"name":"word","in":"query","required":true,"schema":{"type":"string","description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too","title":"Word"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too"},{"name":"n","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"description":"Number of calls; 0 = all","default":8,"title":"N"},"description":"Number of calls; 0 = all"},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD; only calls before it (default: through today)","title":"Before"},"description":"Date YYYY-MM-DD; only calls before it (default: through today)"},{"name":"operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator","title":"Operator"},"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator"},{"name":"analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst","title":"Analyst"},"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst"},{"name":"include_operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Operator"}},{"name":"include_analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Analyst"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/occurrences":{"get":{"tags":["api"],"summary":"Every match of a word in one call","operationId":"occurrences_api_v1_occurrences_get","parameters":[{"name":"call_id","in":"query","required":true,"schema":{"type":"integer","maximum":9223372036854775807,"title":"Call Id"}},{"name":"word","in":"query","required":true,"schema":{"type":"string","description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too","title":"Word"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too"},{"name":"operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator","title":"Operator"},"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator"},{"name":"analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst","title":"Analyst"},"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst"},{"name":"include_operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Operator"}},{"name":"include_analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Analyst"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100000,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":9223372036854775807,"minimum":0,"default":0,"title":"Offset"}},{"name":"plain","in":"query","required":false,"schema":{"type":"boolean","description":"Snippets as plain text with «hit» markers instead of HTML","default":false,"title":"Plain"},"description":"Snippets as plain text with «hit» markers instead of HTML"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/trend":{"get":{"tags":["api"],"summary":"A word's count and rate in every call of a company","operationId":"trend_api_v1_trend_get","parameters":[{"name":"symbol","in":"query","required":true,"schema":{"type":"string","description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted","title":"Symbol"},"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted"},{"name":"word","in":"query","required":true,"schema":{"type":"string","description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too","title":"Word"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too"},{"name":"operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator","title":"Operator"},"description":"Count the operator's speech too (Kalshi rules that mention the operator); alias include_operator"},{"name":"analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst","title":"Analyst"},"description":"Count analysts' speech too (Polymarket's 'anyone' rule); alias include_analyst"},{"name":"include_operator","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Operator"}},{"name":"include_analyst","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Analyst"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/compare":{"get":{"tags":["api"],"summary":"Terms gained / lost / new in call b vs call a (company speech)","operationId":"compare_api_v1_compare_get","parameters":[{"name":"a","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":9223372036854775807},{"type":"null"}],"description":"Base call id","title":"A"},"description":"Base call id"},{"name":"b","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":9223372036854775807},{"type":"null"}],"description":"Call id compared against a","title":"B"},"description":"Call id compared against a"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Instead of a / b: the symbol's previous vs latest call","title":"Symbol"},"description":"Instead of a / b: the symbol's previous vs latest call"},{"name":"top","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":40,"title":"Top"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/events":{"get":{"tags":["api"],"summary":"Mention-market events (earnings JSON shape; next_strikes_preview = word:p)","operationId":"events_api_v1_events_get","parameters":[{"name":"venue","in":"query","required":false,"schema":{"enum":["kalshi","polymarket","all"],"type":"string","default":"all","title":"Venue"}},{"name":"status","in":"query","required":false,"schema":{"enum":["open","closed","settled","all"],"type":"string","default":"open","title":"Status"}},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted (list allowed)","title":"Symbol"},"description":"Stock symbol, e.g. TSLA; a comma / space separated list where noted (list allowed)"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD; call date on or after","title":"From"},"description":"Date YYYY-MM-DD; call date on or after"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date YYYY-MM-DD; call date on or before","title":"To"},"description":"Date YYYY-MM-DD; call date on or before"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":1,"default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":9223372036854775807,"minimum":0,"default":0,"title":"Offset"}},{"name":"preview_n","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":0,"description":"Strikes in next_strikes_preview (open events; 0 = none)","default":6,"title":"Preview N"},"description":"Strikes in next_strikes_preview (open events; 0 = none)"},{"name":"format","in":"query","required":false,"schema":{"enum":["json","tsv","csv"],"type":"string","description":"tsv / csv: one line per event","default":"json","title":"Format"},"description":"tsv / csv: one line per event"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of columns (tsv / csv / json rows): id, venue, ticker, series, symbol, company, title, call_date, call_type, status, close_time, url, n_strikes, volume, call_id, counterpart_id, session, call_date_source, venue_call_date, close_is_placeholder, n_yes, n_no, qa, next_strikes_preview","title":"Fields"},"description":"Comma list of columns (tsv / csv / json rows): id, venue, ticker, series, symbol, company, title, call_date, call_type, status, close_time, url, n_strikes, volume, call_id, counterpart_id, session, call_date_source, venue_call_date, close_is_placeholder, n_yes, n_no, qa, next_strikes_preview"},{"name":"markets","in":"query","required":false,"schema":{"type":"boolean","description":"Add venue prices (bid, ask, last, mid; may be delayed). Off by default (D7)","default":false,"title":"Markets"},"description":"Add venue prices (bid, ask, last, mid; may be delayed). Off by default (D7)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/events/{event_id}":{"get":{"tags":["api"],"summary":"One event: strikes with history stats, published p (p_src), results; prices with markets=1","operationId":"event_api_v1_events__event_id__get","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","title":"Event Id"}},{"name":"compact","in":"query","required":false,"schema":{"type":"boolean","description":"Drop internal keys, raw price subkeys and empty values","default":false,"title":"Compact"},"description":"Drop internal keys, raw price subkeys and empty values"},{"name":"markets","in":"query","required":false,"schema":{"type":"boolean","description":"Add venue prices (bid, ask, last, mid; may be delayed). Off by default (D7)","default":false,"title":"Markets"},"description":"Add venue prices (bid, ask, last, mid; may be delayed). Off by default (D7)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/strikes/{strike_id}/prices":{"get":{"tags":["api"],"summary":"Market endpoint: price snapshots of one strike","operationId":"strike_prices_api_v1_strikes__strike_id__prices_get","parameters":[{"name":"strike_id","in":"path","required":true,"schema":{"type":"string","title":"Strike Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/calendar":{"get":{"tags":["api"],"summary":"Tracked companies' calls in the next N days","operationId":"calendar_api_v1_calendar_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":14,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/qa":{"get":{"tags":["api"],"summary":"Settlement agreement: transcript count vs market result","operationId":"qa_api_v1_qa_get","parameters":[{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Symbol"}},{"name":"venue","in":"query","required":false,"schema":{"anyOf":[{"enum":["kalshi","polymarket"],"type":"string"},{"type":"null"}],"title":"Venue"}},{"name":"mismatch_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Mismatch Only"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":1,"default":500,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":9223372036854775807,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/mcp":{"post":{"tags":["mcp"],"summary":"MCP (Streamable HTTP, stateless, JSON responses)","operationId":"mcp_post_mcp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/entity/{entity_id}":{"get":{"tags":["agents"],"summary":"Entity card: kind, hub, tier, venues, next / last occasion, role holder, top 10 words (key n y rate l10 tn th)","operationId":"entity_card_api_v1_entity__entity_id__get","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias","title":"Entity Id"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"full: add the icon path","title":"Fields"},"description":"full: add the icon path"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/entity":{"get":{"tags":["agents"],"summary":"Entity card by ?id= (same as /api/v1/entity/{id})","operationId":"entity_card_q_api_v1_entity_get","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias","title":"Id"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"full: add the icon path","title":"Fields"},"description":"full: add the icon path"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/entities":{"get":{"tags":["agents"],"summary":"Entities (speakers, shows, companies, leagues, roles) of a hub, a row each with the next open market date","operationId":"entities_api_v1_entities_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Hub id; default all","title":"Category"},"description":"Hub id; default all"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Substring of the id or name","title":"Q"},"description":"Substring of the id or name"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":9223372036854775807,"minimum":0,"default":0,"title":"Offset"}},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/clips":{"get":{"tags":["agents"],"summary":"Timed clips of a word (yt:<video id>@<start>-<end>) from verified timelines, newest first","operationId":"clips_api_v1_clips_get","parameters":[{"name":"word","in":"query","required":true,"schema":{"type":"string","description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too","title":"Word"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too"},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias","title":"Entity"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX","title":"Symbol"},"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX"},{"name":"appearance","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"One appearance (id or slug)","title":"Appearance"},"description":"One appearance (id or slug)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of columns: key, app, date, spk, t, clip, q","title":"Fields"},"description":"Comma list of columns: key, app, date, spk, t, clip, q"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/changes":{"get":{"tags":["agents"],"summary":"What changed since a time: entities, appearances, sources, events (strikes roll up), history; paged by a cursor","operationId":"changes_api_v1_changes_get","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","description":"ISO time (e.g. a previous response's as_of) or the `next` cursor of the previous page","title":"Since"},"description":"ISO time (e.g. a previous response's as_of) or the `next` cursor of the previous page"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"types","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma list of entity, appearance, source, event, strike, history","title":"Types"},"description":"Comma list of entity, appearance, source, event, strike, history"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/appearances/{appearance_id}":{"get":{"tags":["agents"],"summary":"One appearance: people, active source (text kind, rights, timeline), events","operationId":"appearance_api_v1_appearances__appearance_id__get","parameters":[{"name":"appearance_id","in":"path","required":true,"schema":{"type":"string","description":"Appearance id or slug","title":"Appearance Id"},"description":"Appearance id or slug"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/appearances/{appearance_id}/text":{"get":{"tags":["agents"],"summary":"Full text of an appearance, only when its source is public domain or OPL (else 403 rights)","operationId":"appearance_text_api_v1_appearances__appearance_id__text_get","parameters":[{"name":"appearance_id","in":"path","required":true,"schema":{"type":"string","description":"Appearance id or slug","title":"Appearance Id"},"description":"Appearance id or slug"}],"responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/history":{"get":{"tags":["agents"],"summary":"Settlement history: an entity's words (most settled first), or with word= every settled listing of one word","operationId":"history_api_v1_history_get","parameters":[{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias","title":"Entity"},"description":"Entity id (donald-trump, nvidia, the-last-word, role-fed-chair), a name or an alias"},{"name":"symbol","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX","title":"Symbol"},"description":"Earnings stock symbol (alias of entity= for companies), e.g. NFLX"},{"name":"word","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too","title":"Word"},"description":"Word in Kalshi syntax: alternates separated by ' / ', optional threshold '(N+ times)' last, e.g. 'Tariff / Tariffs (3+ times)'; Polymarket's 'Quarter 15+ times' works too"},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Without word: keys containing this text","title":"Q"},"description":"Without word: keys containing this text"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"description":"First row (the '# more: offset=' of the previous page)","default":0,"title":"Offset"},"description":"First row (the '# more: offset=' of the previous page)"},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/status/worker":{"get":{"tags":["ingest"],"summary":"Mac worker backlog and heartbeat (for the watchdog)","operationId":"worker_status_api_v1_status_worker_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/sports":{"get":{"tags":["sports"],"summary":"Sports hub: per-league status, counts and next game, plus the live strip (history only)","operationId":"r_hub_api_v1_sports_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/sports/live":{"get":{"tags":["sports"],"summary":"Games with open or unresolved sports markets (upcoming, live or awaiting resolution)","operationId":"r_live_api_v1_sports_live_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"markets","in":"query","required":false,"schema":{"type":"integer","maximum":1,"minimum":0,"default":0,"title":"Markets"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/sports/ufc/lengths":{"get":{"tags":["sports"],"summary":"UFC: YES share of settled bout words by how long the fight lasted","operationId":"r_ufc_api_v1_sports_ufc_lengths_get","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/sports/games":{"get":{"tags":["sports"],"summary":"Games by league, date window (ET) and whether they listed markets","operationId":"r_games_api_v1_sports_games_get","parameters":[{"name":"league","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"League"}},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d\\d-\\d\\d$"},{"type":"null"}],"title":"Start"}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d\\d-\\d\\d$"},{"type":"null"}],"title":"End"}},{"name":"listed","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":1,"minimum":0},{"type":"null"}],"title":"Listed"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/sports/games/{app_id}":{"get":{"tags":["sports"],"summary":"One game: facts, linked market events and each listed word with league history and result","operationId":"r_game_api_v1_sports_games__app_id__get","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string","title":"App Id"}},{"name":"markets","in":"query","required":false,"schema":{"type":"integer","maximum":1,"minimum":0,"default":0,"title":"Markets"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":1000,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/sports/{league}/words":{"get":{"tags":["sports"],"summary":"A league's word board: games that listed each word, settled YES rate, last 10 and p","operationId":"r_board_api_v1_sports__league__words_get","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","title":"League"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(listed|rate)$","default":"listed","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/sports/{league}/teams/{team_id}":{"get":{"tags":["sports"],"summary":"A team: words whose YES rate in its games differs most from the league, and its games","operationId":"r_team_api_v1_sports__league__teams__team_id__get","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","title":"League"}},{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/sports/{league}/networks/{network}":{"get":{"tags":["sports"],"summary":"Word YES rates in one network's games of a league, with the league rate beside each","operationId":"r_network_api_v1_sports__league__networks__network__get","parameters":[{"name":"league","in":"path","required":true,"schema":{"type":"string","title":"League"}},{"name":"network","in":"path","required":true,"schema":{"type":"string","title":"Network"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","pattern":"^(tsv|json|md)$","default":"tsv","title":"Format"}},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fields"}},{"name":"if-none-match","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"If-None-Match"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/window":{"get":{"tags":["agents"],"summary":"One window market (this week / this month / posts): per word the spoken count, the posts count and both, the market's own count; part=apps lists the window's appearances with coverage","operationId":"window_ep_api_v1_window_get","parameters":[{"name":"event","in":"query","required":true,"schema":{"type":"string","description":"Event id (k:... / p:...)","title":"Event"},"description":"Event id (k:... / p:...)"},{"name":"part","in":"query","required":false,"schema":{"enum":["words","apps"],"type":"string","default":"words","title":"Part"}},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}},"/api/v1/windows":{"get":{"tags":["agents"],"summary":"Window markets, a row each: window, scope, known appearances, with text, own posts, listed words","operationId":"windows_ep_api_v1_windows_get","parameters":[{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity"}},{"name":"status","in":"query","required":false,"schema":{"enum":["open","all"],"type":"string","default":"open","title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"format","in":"query","required":false,"schema":{"enum":["tsv","json","md"],"type":"string","default":"tsv","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Bad request: {\"error\": \"bad_request\", \"detail\": ...}"}}}}},"components":{"schemas":{"Decision":{"properties":{"action":{"type":"string","enum":["accept","link","reject","none","dismiss","unlink"],"title":"Action"},"appearance_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Appearance Id"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["action"],"title":"Decision"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}