Get User Orders

Returns a bare, newest-first array of the effective profile’s orders for one exact market slug. Omitted statuses default to LIVE. Partner HMAC tokens with delegated_signing may select an owned sub-account with x-on-behalf-of.

GET /markets/{slug}/user-orders

User Orders

cURL

curl --request GET \
  --url https://api.limitless.exchange/markets/{slug}/user-orders \
  --header 'lmts-api-key: <api-key>'

200

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "ownerId": 123,
    "marketId": "<string>",
    "token": "<string>",
    "type": "GTC",
    "status": "LIVE",
    "side": "BUY",
    "makerAmount": "<string>",
    "takerAmount": "<string>",
    "price": "0.5",
    "originalSize": "<string>",
    "remainingSize": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "clientOrderId": "<string>"
  }
]

Returns a bare JSON array of orders for the effective profile and one exact market slug. Group slugs and stable-slug aliases are not accepted. Results are ordered newest first.

Authentication and delegation

Use HMAC authentication. Looking up your own orders does not require a specific token scope.

To read a managed sub-account, send x-on-behalf-of: <profileId>. The HMAC token must carry delegated_signing, and the target profile must belong to the authenticated partner.

Status filters

If statuses is omitted, the API returns live orders.

Supported status filters are LIVE, MATCHED, CANCELED, and UNMATCHED. Repeat the query parameter to request multiple statuses. Values are case-insensitive.

A taker rejected by self-trade prevention terminates as CANCELED (the placement response carries execution.reason: "STP_TAKER_REJECTED"); filter for it with CANCELED.

Limit and response

When supplied, limit must be an integer from 1 through 200. If omitted, the result is unbounded. The endpoint has no cursor, page, total, or other pagination metadata.

The response is the array itself, not an { "orders": [...] } envelope. Each item contains the internal order and owner/market/token identifiers, order type, status, side, maker and taker amounts, price, original and remaining size, and creation time. Numeric values are serialized as decimal strings. clientOrderId is present only when the order was placed with one.

An existing market with no matching orders returns [].

Errors

Status	Meaning
400	A path/query value or the delegated header is invalid, or an unknown query field was supplied.
401	Authentication failed.
403	Delegation lacks delegated_signing or the target is not owned by the partner.
404	The exact market slug or effective profile was not found.
500	The user-order lookup failed unexpectedly.

Authorizations

lmts-api-key · string · header · required

Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.

Headers

x-on-behalf-of · integer

Managed sub-account profile ID. Requires an HMAC token with delegated_signing and a partner relationship with the target.

Required range: 1 <= x <= 2147483647

Example:

326

Path Parameters

slug · string · required

Exact market slug. Group slugs and stable-slug aliases are not resolved.

Example:

"presidential-election-2024"

Query Parameters

statuses · enum<string>[]

Repeat to filter by one or more statuses. Values are case-insensitive and normalized to uppercase. Defaults to LIVE when omitted.

Available options: LIVE, MATCHED, CANCELED, UNMATCHED

limit · integer

Maximum newest orders to return. Must be 1–200 when supplied.

Required range: 1 <= x <= 200

Example:

100

Response

200

application/json

Bare newest-first array; an existing market with no matching orders returns []

id · string<uuid> · required

Internal order ID.

ownerId · integer · required

Profile that owns the order.

marketId · string · required

Internal market ID serialized as text.

token · string · required

Conditional position token ID.

type · enum<string> · required

Available options: GTC, FAK, FOK

status · enum<string> · required

Available options: LIVE, MATCHED, CANCELED, UNMATCHED

side · enum<string> · required

Available options: BUY, SELL

makerAmount · string · required

Maker amount in raw 6-decimal units, serialized as a decimal string.

Pattern: ^[0-9]+(?:\.[0-9]+)?$

takerAmount · string · required

Taker amount in raw 6-decimal units, serialized as a decimal string.

Pattern: ^[0-9]+(?:\.[0-9]+)?$

price · string · required

Order price serialized as a decimal string.

Pattern: ^[0-9]+(?:\.[0-9]+)?$

Example:

"0.5"

originalSize · string · required

Original contract size in raw 6-decimal units, serialized as a decimal string.

Pattern: ^[0-9]+(?:\.[0-9]+)?$

remainingSize · string · required

Unfilled contract size in raw 6-decimal units, serialized as a decimal string.

Pattern: ^[0-9]+(?:\.[0-9]+)?$

createdAt · string<date-time> · required

clientOrderId · string

Caller-assigned identifier when the order was placed with one.