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

venue
enum<string>

Only holdings on this venue. Other venues are not read, so only this one can be unavailable.

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

Only holdings 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 holding trades. A holding with no listed market never matches.

Required string length: 1 - 100

Response

Open positions of the key’s trading account

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