Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Authorization: Bearer tl_live_…

Path Parameters

id
string
required

our id for the order, as the place answer gave it: ord_ and 24 hex digits

Pattern: ^ord_[0-9a-f]{24}$

Response

Successful Response

client_order_id
string
required

your id for this order

created_at
string
required

when we accepted the order, ISO 8601

id
string
required

our id for the order, ord_ and 24 hex digits; it exists from the moment we accept the request, so an order whose status is unknown has one too

Pattern: ^ord_[0-9a-f]{24}$
notional_reserved
string
required

the order's maximum loss counted against your limits, USD as a decimal string

outcome
string
required

the venue's own outcome label

price
string
required

the limit price of outcome, a decimal string

side
enum<string>
required

buy or sell, the action on outcome at price

Available options:
buy,
sell
size
integer
required

whole contracts ordered

status
enum<string>
required

unknown: the venue's answer was not received; retry with the same client_order_id or read GET /public/v1/orders/{id}, never send a new id. On a venue that cannot prove an order's absence it may stay unknown: check the venue before trading the same intent again

Available options:
open,
filled,
partially_filled,
cancelled,
unknown,
not_placed
time_in_force
enum<string>
required

as requested

Available options:
gtc,
ioc
type
string
required

the order type; only limit

Allowed value: "limit"
universal_id
string | null
required

the market universal id holding the leg; null when no market lists it

updated_at
string
required

when we last recorded a change to the order, ISO 8601

venue
enum<string>
required

the venue the order was sent to

Available options:
kalshi,
polymarket,
limitless,
predictfun
venue_market_id
string
required

the venue's own market id the order went to

avg_price
string | null

the average fill price of outcome, 0..1 as a decimal string, when the venue reported one

filled_size
string | null

contracts filled, an exact decimal string; null while the status is unknown

remaining_size
string | null

contracts still resting, an exact decimal string; null while the status is unknown

venue_market_title
string | null

the leg's title on the venue, when our mirror holds it

venue_order_id
string | null

the venue's order id; null while the status is unknown and for an order that was never placed