Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

A Lean API key, sent as Authorization: Bearer <key>. A test key (lean_sk_test_...) simulates orders and fills with no money; a live key (lean_sk_live_...) trades for real within the key's limits. Every successful response says which mode answered in data.livemode.

Query Parameters

symbol
string

Look up the markets one venue symbol trades: a leg ticker (pm:…, hl:…, pmus:… or a Kalshi market ticker), a Polymarket condition id or token id, or a Hyperliquid book coin (#…). The start window, cursor and other filters except venue do not apply.

Required string length: 1 - 200

Words matched the way the Lean app search matches them: every word against Kalshi, Polymarket, Polymarket US and Hyperliquid market and event titles in any letter case, the last word as a prefix, with common team nicknames and small typos tried when few markets match. Only markets with a leg that matches are listed, in the usual start order, and the other filters and cursor apply as without it. A search covers the venue markets of the fixtures in the start window, at most 10,000 matching ones, open ones first and then by start, so narrow broad words with league, sport or the start window. To list a whole league, use league.

Required string length: 1 - 100
category
enum<string>

Market category. Every listed market is sports today.

Available options:
sports
sport
string

Only fixtures of this sport, such as football.

Required string length: 1 - 32
league
string
Required string length: 1 - 32
Example:

"nfl"

fixture
string

Only markets of this fixture, by its exact fixture.key. The start window still applies, so a fixture that starts outside it lists nothing.

Required string length: 1 - 512
group
string

Only markets of propositions with this exact group.key, such as moneyline:game. With fixture, lists one proposition of one fixture; without it, that proposition in every fixture the other filters keep.

Required string length: 1 - 200
venue
enum<string>

Only markets with a leg on this venue.

Available options:
kalshi,
polymarket,
polymarket_us,
hyperliquid
status
enum<string>

open: at least one venue leg is tradable. closed: no leg is, including markets whose legs are only unopened or resolving.

Available options:
open,
closed
starts_after
string<date-time>

Only fixtures starting at or after this time. Defaults to 12 hours ago.

starts_before
string<date-time>

Only fixtures starting before this time. Defaults to 30 days ahead, so season futures such as a championship final are listed only when this is set past their start. Their market ids resolve at any time.

limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string
Required string length: 1 - 512

Response

Canonical markets with their venue legs

success
enum<boolean>
required
Available options:
true
data
object
required
meta
object
required