'%20d='M0%200H100C119%200%20128%209%20128%2028V39C128%2050%20122%2057%20110%2061C122%2065%20128%2074%20128%2087V100H92V88C92%2077%2088%2073%2077%2073H34V100H0ZM34%2025V49H79C89%2049%2092%2045%2092%2037C92%2029%2089%2025%2079%2025Z'/%3e%3cpath%20transform='translate(144)'%20d='M0%200H38V100H0Z'/%3e%3cpath%20transform='translate(198)'%20d='M0%200H107C130%200%20140%2010%20140%2033V67C140%2090%20130%20100%20107%20100H0ZM35%2027V73H96C103%2073%20106%2070%20106%2063V37C106%2030%20103%2027%2096%2027Z'/%3e%3cpath%20transform='translate(354)'%20d='M0%200H107C130%200%20140%2010%20140%2033V67C140%2090%20130%20100%20107%20100H0ZM35%2027V73H96C103%2073%20106%2070%20106%2063V37C106%2030%20103%2027%2096%2027Z'/%3e%3cpath%20transform='translate(510)'%20d='M0%200H34V73H120V100H0Z'/%3e%3cpath%20transform='translate(646)'%20d='M0%200H128V25H34V38H118V62H34V75H128V100H0Z'/%3e%3c/g%3e%3c/svg%3e)
Introduction
Riddle brings prediction market contracts from Kalshi, Polymarket and Limitless into one shape so your code stops writing a new adapter for every venue.
Each venue publishes its own identifiers, price conventions and market metadata. A research system that wants to reason across venues spends most of its time reconciling those differences instead of using the data. The Riddle API does that reconciliation once and hands back a single shape.
Base URLPermalink to this section
https://nybvquiiaarqmgpraxaq.supabase.co/functions/v1/public-apiWhat the API returnsPermalink to this section
- List and search: markets across covered platforms, filtered by title substring, platform and category, with cursor pagination.
- Market detail: one market addressed by its platform and platform market id.
- History: Riddle observations of a market over a requested window.
- Service endpoints: health, capabilities and the machine-readable OpenAPI document.
What it does not doPermalink to this section
- No order placement, routing or execution. Riddle is a research and information platform, not a broker, exchange or trading venue.
- No executable quotes. Probabilities are indicative observations, not prices you can trade at.
- No claim that two contracts on different platforms are economically equivalent. Search returns candidates that match a title substring; wording and settlement still need checking at the venue.
- No venue status, close time or settlement fields, and no order book, OHLCV or volume time series.
- No streaming or websocket transport.
How these docs are organisedPermalink to this section
- Getting started walks through a first request end to end.
- Authentication covers the x-api-key header and key handling.
- Markets is the endpoint reference for list and search, market detail and history.
- Service endpoints covers health, capabilities and the OpenAPI document.
- Data semantics explains probabilities, identifiers, timestamps and feed presence so the numbers are not misread.
- Errors and Rate limits cover failure handling and the development ceilings.
- Changelog records contract changes so an integration can track them.
Kalshi, Polymarket and Limitless are named for identification only. Riddle is not affiliated with, endorsed by or sponsored by any of them, and nothing in these docs is financial, investment or trading advice.