Get User Orders

User Orders

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

const options = {method: 'GET', headers: {'lmts-api-key': '<api-key>'}};

fetch('https://api.limitless.exchange/markets/{slug}/user-orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.limitless.exchange/markets/{slug}/user-orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "lmts-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.limitless.exchange/markets/{slug}/user-orders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("lmts-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.limitless.exchange/markets/{slug}/user-orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["lmts-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "6f52b6d2-6c9e-4a5c-8a4f-28ab4b7ff203",
    "ownerId": 326,
    "marketId": "1842",
    "token": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
    "type": "GTC",
    "status": "LIVE",
    "side": "BUY",
    "makerAmount": "5000000",
    "takerAmount": "10000000",
    "price": "0.5",
    "originalSize": "10000000",
    "remainingSize": "7500000",
    "createdAt": "2026-08-18T08:00:00.000Z",
    "clientOrderId": "mm-order-123"
  }
]

GET

markets

{slug}

user-orders

User Orders

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

const options = {method: 'GET', headers: {'lmts-api-key': '<api-key>'}};

fetch('https://api.limitless.exchange/markets/{slug}/user-orders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.limitless.exchange/markets/{slug}/user-orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "lmts-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.limitless.exchange/markets/{slug}/user-orders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("lmts-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.limitless.exchange/markets/{slug}/user-orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["lmts-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "id": "6f52b6d2-6c9e-4a5c-8a4f-28ab4b7ff203",
    "ownerId": 326,
    "marketId": "1842",
    "token": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
    "type": "GTC",
    "status": "LIVE",
    "side": "BUY",
    "makerAmount": "5000000",
    "takerAmount": "10000000",
    "price": "0.5",
    "originalSize": "10000000",
    "remainingSize": "7500000",
    "createdAt": "2026-08-18T08:00:00.000Z",
    "clientOrderId": "mm-order-123"
  }
]

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; omission is unbounded.

Required range: 1 <= x <= 200

Example:

100

Response

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

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.

⌘I

Overview

System

Authentication

Markets

Trading

Portfolio

Market Pages & Navigation

API Tokens

Partner Accounts

Public Portfolio

Referral

Leaderboard

Authentication and delegation

Status filters

Limit and response

Errors

Authorizations

Headers

Path Parameters

Query Parameters

Response

​Authentication and delegation

​Status filters

​Limit and response

​Errors

Authorizations

Headers

Path Parameters

Query Parameters

Response

Authentication and delegation

Status filters

Limit and response

Errors