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

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

Only orders placed with this client_order_id by any key on this trading account. It is unique per key, so orders from different keys can share one.

Pattern: ^[A-Za-z0-9_-]{1,64}$
Example:

"bot-0001"

status
enum<string>

Only orders in this status.

Available options:
pending,
open,
partially_filled,
filled,
canceled,
rejected,
expired,
unconfirmed,
needs_attention,
cancel_requested
venue
enum<string>

Only orders on this venue: a venue order there, or a routed order not yet placed that trades there.

Available options:
kalshi,
polymarket,
polymarket_us,
hyperliquid
market_id
string

Only orders on this market. A market id from GET /markets, or a venue symbol that names one market: a Polymarket token id, a Hyperliquid book coin (#…, written %23… in a path), or a leg ticker (pm:…, hl:…, pmus:… or a Kalshi market ticker) that lists only this outcome. A symbol that names more than one market, such as a Polymarket condition id, is refused with 400; use the token id or the market id instead.

Required string length: 1 - 512

Text, in any letter case, found in the title or outcome of the market the order trades.

Required string length: 1 - 100
created_after
string<date-time>

Only orders placed at or after this time.

created_before
string<date-time>

Only orders placed before this time.

Response

API orders on this key's trading account, newest first

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