Get Order Status (Batch)

curl --request POST \
  --url https://api.limitless.exchange/orders/status/batch \
  --header 'Content-Type: application/json' \
  --header 'lmts-api-key: <api-key>' \
  --data '
{
  "items": [
    {
      "orderId": "4aa706dd-6c57-4f3c-945a-99818dfd95f1"
    },
    {
      "orderId": "6f52b6d2-6c9e-4a5c-8a4f-28ab4b7ff203"
    }
  ]
}
'

{
  "results": [
    {
      "index": 0,
      "status": "found",
      "error": "Exactly one of orderId or clientOrderId is required",
      "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "clientOrderId": "<string>",
      "data": {
        "order": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "salt": "1778155025318314496",
          "maker": "<string>",
          "signer": "<string>",
          "tokenId": "<string>",
          "signature": "<string>",
          "marketId": "<string>",
          "ownerId": 123,
          "createdAt": "2023-11-07T05:31:56Z",
          "market": {
            "id": 123,
            "slug": "<string>",
            "title": "<string>",
            "yesPositionId": "<string>",
            "noPositionId": "<string>",
            "group": {
              "id": 123,
              "slug": "<string>",
              "title": "<string>"
            }
          },
          "makerAmount": "5000000",
          "takerAmount": "10000000",
          "nonce": "0",
          "owner": {
            "id": 123,
            "account": "<string>",
            "client": "<string>",
            "smartWallet": "<string>",
            "points": 0,
            "referredUsersCount": 0
          },
          "taker": "<string>",
          "expiration": "2023-11-07T05:31:56Z",
          "feeRateBps": 123,
          "price": "0.75"
        },
        "execution": {
          "feeRateBps": 0,
          "effectiveFeeBps": 0,
          "matched": true,
          "totalsRaw": {
            "contractsGross": "1000000",
            "contractsFee": "1000",
            "contractsNet": "999000",
            "usdGross": "500000",
            "usdFee": "500",
            "usdNet": "499500"
          },
          "clientOrderId": "<string>",
          "eligibleAt": "2023-11-07T05:31:56Z",
          "tradeEventId": "<string>",
          "txHash": "<string>"
        },
        "makerMatches": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "matchedSize": "1000000",
            "fillPrice": "0.55",
            "fillCost": "550000",
            "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "order": {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "maker": "<string>",
              "price": "0.55",
              "tokenId": "<string>",
              "owner": {
                "id": 123,
                "account": "<string>",
                "client": "<string>",
                "smartWallet": "<string>",
                "username": "<string>",
                "displayName": "<string>",
                "pfpUrl": "<string>",
                "socialUrl": "<string>",
                "points": 0,
                "referredUsersCount": 0
              }
            }
          }
        ]
      }
    }
  ]
}

{
  "message": [
    {
      "field": "items.0.orderId",
      "message": "orderId must be a UUID"
    }
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": "Invalid HMAC authentication",
  "error": "Unauthorized",
  "statusCode": 401
}

{
  "message": "Delegation requires an API token with delegated_signing scope",
  "error": "Forbidden",
  "statusCode": 403
}

{
  "message": "Internal server error"
}

POST

orders

status

batch

curl --request POST \
  --url https://api.limitless.exchange/orders/status/batch \
  --header 'Content-Type: application/json' \
  --header 'lmts-api-key: <api-key>' \
  --data '
{
  "items": [
    {
      "orderId": "4aa706dd-6c57-4f3c-945a-99818dfd95f1"
    },
    {
      "orderId": "6f52b6d2-6c9e-4a5c-8a4f-28ab4b7ff203"
    }
  ]
}
'

{
  "results": [
    {
      "index": 0,
      "status": "found",
      "error": "Exactly one of orderId or clientOrderId is required",
      "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "clientOrderId": "<string>",
      "data": {
        "order": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "salt": "1778155025318314496",
          "maker": "<string>",
          "signer": "<string>",
          "tokenId": "<string>",
          "signature": "<string>",
          "marketId": "<string>",
          "ownerId": 123,
          "createdAt": "2023-11-07T05:31:56Z",
          "market": {
            "id": 123,
            "slug": "<string>",
            "title": "<string>",
            "yesPositionId": "<string>",
            "noPositionId": "<string>",
            "group": {
              "id": 123,
              "slug": "<string>",
              "title": "<string>"
            }
          },
          "makerAmount": "5000000",
          "takerAmount": "10000000",
          "nonce": "0",
          "owner": {
            "id": 123,
            "account": "<string>",
            "client": "<string>",
            "smartWallet": "<string>",
            "points": 0,
            "referredUsersCount": 0
          },
          "taker": "<string>",
          "expiration": "2023-11-07T05:31:56Z",
          "feeRateBps": 123,
          "price": "0.75"
        },
        "execution": {
          "feeRateBps": 0,
          "effectiveFeeBps": 0,
          "matched": true,
          "totalsRaw": {
            "contractsGross": "1000000",
            "contractsFee": "1000",
            "contractsNet": "999000",
            "usdGross": "500000",
            "usdFee": "500",
            "usdNet": "499500"
          },
          "clientOrderId": "<string>",
          "eligibleAt": "2023-11-07T05:31:56Z",
          "tradeEventId": "<string>",
          "txHash": "<string>"
        },
        "makerMatches": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "matchedSize": "1000000",
            "fillPrice": "0.55",
            "fillCost": "550000",
            "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "order": {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "maker": "<string>",
              "price": "0.55",
              "tokenId": "<string>",
              "owner": {
                "id": 123,
                "account": "<string>",
                "client": "<string>",
                "smartWallet": "<string>",
                "username": "<string>",
                "displayName": "<string>",
                "pfpUrl": "<string>",
                "socialUrl": "<string>",
                "points": 0,
                "referredUsersCount": 0
              }
            }
          }
        ]
      }
    }
  ]
}

{
  "message": [
    {
      "field": "items.0.orderId",
      "message": "orderId must be a UUID"
    }
  ],
  "error": "Bad Request",
  "statusCode": 400
}

{
  "message": "Invalid HMAC authentication",
  "error": "Unauthorized",
  "statusCode": 401
}

{
  "message": "Delegation requires an API token with delegated_signing scope",
  "error": "Forbidden",
  "statusCode": 403
}

{
  "message": "Internal server error"
}

Look up orders by either orderId (internal) or clientOrderId (your identifier). Provide exactly one per item, not both.

Authentication and delegation

Use HMAC authentication. Looking up your own orders does not require a specific token scope. To look up 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.

Validation behavior

The request accepts 1–50 items and preserves their input order in results through the index field.

An item with both identifiers, neither identifier, or a blank clientOrderId returns an item-level status: "invalid"; the rest of the batch is processed.
An unknown identifier, including an order owned by another profile, returns item-level status: "not_found".
Malformed UUIDs or field types, client IDs longer than 128 characters, unknown fields, malformed nesting, and batch-size violations reject the whole request with 400 Bad Request.

For status: "found", data directly contains order, optional makerMatches, and execution. There is no additional response envelope inside data.order. Historical status reports UNMATCHED, DELAYED, MATCHED, MINED, CONFIRMED, RETRYING, or FAILED. It returns the latest known execution state; it does not include placement-time STP reasons, STP maker-cancel IDs, or a historical CANCELED state.

Errors

Status	Meaning
`400`	Whole-request validation failed, the delegated header is malformed, or the authenticated profile cannot be resolved.
`401`	Authentication failed.
`403`	Delegation lacks `delegated_signing` or the target is not owned by the partner.
`500`	Historical status 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

Body

application/json

items

object[]

required

List of status lookup queries (1-50 items)

Required array length: 1 - 50 elements

Show child attributes

Response

Batch order statuses

results

object[]

required

Array of status results corresponding to request items

Show child attributes

⌘I

Overview

System

Authentication

Markets

Trading

Portfolio

Market Pages & Navigation

API Tokens

Partner Accounts

Public Portfolio

Referral

Leaderboard

Authentication and delegation

Validation behavior

Errors

Authorizations

Headers

Body

Response

​Authentication and delegation

​Validation behavior

​Errors

Authorizations

Headers

Body

Response

Authentication and delegation

Validation behavior

Errors