Skip to content
UDX
2026-07-15
2026-07-15Latest
Esc
↑↓navigate↵open⌘Jpreview

List Orders

Returns a page of orders. A list filtered to resting and partially_filled only is served from the live working view. A list with no status filter or with any terminal status is served from history, which converges later. Without an account_id filter, or with several accounts in it, an account is included only after its setup and the setup of your access to it have both completed.

GET/orders
Authorization
Authorization
UDX-Access-KeyAPI key · headerrequired

Opaque API key ID.

UDX-Access-TimestampAPI key · headerrequired

Unix time in milliseconds, within 30 seconds of server time.

UDX-Access-SignatureAPI key · headerrequired

Standard-base64 RSA-PSS/SHA-256 signature with a 32-byte salt.

or
AuthorizationBearer token (JWT) · headerrequired

Bearer token for an active signed-in UDX user.

Header parameters
Header parameters
UDX-Versionstring

Dated API version (YYYY-MM-DD).

min length 10 · max length 10
Query parameters
client_order_idClientId

Filter by your correlation identifier.

tickerTicker

Filter by market ticker.

min length 1 · max length 128
account_idEntityId[]

Filter to these accounts. An account you cannot read matches no orders. Repeat the account_id parameter for each value.

min items 1 · max items 50
statusOrderStatus[]

Select any single status; resting and partially_filled together; or filled, canceled, expired, and rejected together. Omit status or select every status for all orders. Other combinations return 400. Repeat the status parameter for each value.

min items 1
limitinteger

Page size.

min 1 · max 1000 · default: 10
pagestring

Opaque token identifying the requested page.

max length 512
Responses
200A page of the caller's orders.
ordersOrder[]required

One page of orders.

max items 100
Show properties
Array of Order
order_idEntityIdrequired

An exchange-assigned identifier. Treat it as an opaque, stable key with no internal structure.

min length 1
client_order_idClientId

A client-supplied correlation identifier.

account_idstringrequired

The account the order was placed under.

min length 1
tickerTickerrequired

A human-meaningful natural key naming a single-leg or multi-leg market.

min length 1 · max length 128
sideOrderSiderequired

Order side.

Allowed:buysell
quantityFixedPointQuantityrequired

A quantity in contracts as a fixed-point decimal string.

max length 24 · matches ^[0-9]+(\.[0-9]{1,2})?$
pricestringrequired

Limit price in YES price space, in dollars, regardless of side.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$
time_in_forceOrderTimeInForcerequired

Order time in force.

Allowed:gtciocfokdaygttunknown
expires_atstring<date-time>

When the order expires. Present only when time_in_force is gtt.

max length 40
statusOrderStatusrequired

An order's status.

Allowed:restingpartially_filledfilledcanceledexpiredrejected
rejection_reasonstring

Why the exchange rejected the order. Present only when status is rejected.

Allowed:duplicate_client_order_idself_trade_preventedmarket_closedinsufficient_fundsprice_out_of_boundsquantity_out_of_boundspost_only_would_crossno_liquidityquote_unavailablequote_terms_mismatchquote_already_acceptedrate_limitedexpires_at_invalidexchange_rejected
filled_quantitystringrequired

The quantity of the order that has been filled.

max length 24 · matches ^[0-9]+(\.[0-9]{1,2})?$
remaining_quantitystringrequired

The quantity of the order that is currently resting.

max length 24 · matches ^[0-9]+(\.[0-9]{1,2})?$
average_fill_pricestring

Volume-weighted average fill price. Present when filled_quantity > 0.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$
fees_paidstringrequired

Total fees collected on the order so far, in dollars.

max length 24 · matches ^[0-9]+(\.[0-9]{1,6})?$
created_atstring<date-time>required

When the order was created.

max length 40
next_page_urlNextPageURL | nullrequired

Root-relative URL for the next page. Null when there are no more items.

max length 4096 · matches ^/[^/\s#][^\s#]*$
400The request doesn't conform to this spec.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
401No valid credential was provided.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
403The credential lacks the read scope.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
429The member rate limit was exceeded.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
500Something went wrong on UDX's side.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
503Request admission or account setup is unavailable, or the read could not be completed in time; retry.
typestring<uri-reference>required

A stable URN identifying the kind of problem, for example urn:udx:problem:insufficient-permissions. Branch on it rather than on the localized detail. It is an identifier, not a URL to dereference.

max length 2048
titlestringrequired

A localized, human-readable summary of the error category. Stable for a given status code and resolved language — clients must not use it as a machine-readable discriminator.

max length 40
statusintegerrequired

The HTTP status code, repeated from the response itself.

detailstring

A localized, human-readable explanation specific to this occurrence. Clients must not parse it for machine-readable information.

max length 500
instancestring<uri-reference>

An identifier for this specific occurrence, so it can be correlated with server-side logs if you need to report it.

max length 100
Request
curl -X GET "https://api.underdogexchange.com/orders" \
  -H "UDX-Access-Key: API_KEY_ID" \
  -H "UDX-Access-Timestamp: UNIX_MILLISECONDS" \
  -H "UDX-Access-Signature: BASE64_SIGNATURE"
Response
{
  "orders": [
    {
      "order_id": "BK9BZNTK8022",
      "client_order_id": "order-20260804-001",
      "account_id": "6820943174116859281",
      "ticker": "UDX-EXAMPLE-MARKET",
      "side": "buy",
      "quantity": "100",
      "price": "0.55",
      "time_in_force": "gtc",
      "status": "partially_filled",
      "filled_quantity": "40",
      "remaining_quantity": "60",
      "average_fill_price": "0.54",
      "fees_paid": "0.22",
      "created_at": "2026-01-01T00:00:00.000000Z"
    }
  ],
  "next_page_url": null
}