---
title: "Get orders"
method: GET
path: "/orders"
tags: ["Orders"]
---

# Get orders

`GET /orders`

This endpoint returns active orders on the exchange based on a few parameters

## Query parameters

- `marketHashes` string[]
- `baseToken` string
- `maker` string
- `sportXeventId` string
- `orderHashes` string[]
- `page` integer
- `perPage` integer
- `sortBy` 'fill_amount' | 'total_bet_size' | 'percentage_odds' | 'api_expiry' | 'created_at' | 'updated_at'
- `sortAsc` boolean

## Response `200`

- object
  - `status` string — `success` or `failure` if the request succeeded or not
  - `data` Order[]
    - `marketHash` string — The market corresponding to this order
    - `fillAmount` string — How much this order has been filled in Ethereum units up to a max of `totalBetSize`. See the token section of how to convert this into nominal amounts
    - `pendingFillAmount` string — The pending fill amount of this order in Ethereum units. See the token section for how to convert this into nominal amounts.
    - `orderHash` string — A unique identifier for this order
    - `maker` string — The market maker for this order
    - `totalBetSize` string — The total size of this order in Ethereum units. See the the token section section for how to convert this into nominal amounts.
    - `percentageOdds` string — The odds that the `maker` receives in the sx.bet protocol format. To convert to an implied odds divide by 10^20. To convert to the odds that the taker would receive if this order would be filled in implied format, use the formula `takerOdds=1-percentageOdds/10^20`. See the unit conversion section for more details.
    - `baseToken` string — The base token this order is denominated in
    - `executor` string — The address permitted to execute on this order. This is set to the sx.bet exchange
    - `salt` string — A random number to differentiate identical orders
    - `isMakerBettingOutcomeOne` boolean — `true` if the maker is betting outcome one (and hence taker is betting outcome two if filled)
    - `signature` string — Signature of the maker on this order
    - `expiry` number — Deprecated: the time in unix seconds after which this order is no longer valid. After deprecation, this field is always 2209006800 (2040)
    - `apiExpiry` number — The time in unix seconds after which this order is no longer valid.
    - `sportXeventId` string — The event related to this order
    - `orderStatus` string — The current status of the order. Possible values: `ACTIVE`, `INACTIVE`
  - `page` integer — The current page number
  - `perPage` integer — The number of records per page

## Other responses

- `400` — Error Codes: `RATE_LIMIT_ORDER_REQUEST_MARKET_COUNT` — More than 1000 `marketHashes` queried `BOTH_SPORTXEVENTID_MARKETHASHES_PRESENT` — Can only send one of `marketHashes` or `sportXeventId` `BASE_TOKEN_MISMATCH` — The provided `baseToken` does not match the orders `RATE_LIMIT_ORDER_REQUEST_ORDER_COUNT` — Too many `orderHashes` queried

---

[API](https://skmtc.net/sx/apis/sx-bet-api.md) · [All operations](https://skmtc.net/sx/apis/sx-bet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sx/sx-bet-api/versions/eb2c05c3a98e/schema)