---
title: "Retrieve orders list"
method: GET
path: "/openapi/v1/orders/list"
tags: ["Orders"]
---

# Retrieve orders list

`GET /openapi/v1/orders/list`

This endpoint can be used to fetch orders from the system

## Query parameters

- `chain` 'eth' | 'bsc' | 'polygon' | 'avalanche' | 'arbitrum' | 'zksync' | 'linea' | 'starknet' | 'opbnb' | 'base' | 'scroll' | 'manta_pacific' | 'optimism' | 'mantle' | 'zkfair' | 'blast' | 'merlin' | 'mode' | 'cyber' | 'bob' | 'lightlink' | 'zeta' | 'nibiru' | 'abstract' | 'bitlayer' | 'mantra' | 'monad' | 'ink', required
- `asset_contract_address` string
- `token_ids` string
- `sale_kind` string
- `side` string
- `maker` string
- `taker` string
- `payment_token` string
- `order_by` 'created_date' | 'base_price'
- `direction` 'desc' | 'asc'
- `listed_before` string
- `listed_after` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- ApiResponseQueryOrderList
  - `code` integer — Error Code
  - `msg` string — Error Message
  - `data` QueryOrderList — Return data, Generic
    - `orders` QueryOrderItem[] — Order List
      - `chain` string — Chain Name
      - `chainId` string — Chain ID
      - `orderHash` string — Order Hash
      - `orderId` string — Order Id
      - `expirationTime` integer — Order expiration time
      - `listingTime` integer — Order listing time
      - `createTime` integer — Order create time
      - `maker` string — The order maker's wallet address
      - `taker` string — The order taker's wallet address
      - `side` integer — Side of the order. 0 for buy orders and 1 for sell orders.
      - `saleKind` integer — Kind of sell order. 0 for standard order, 3 for bulk listings, 7 for collection offer.
      - `paymentToken` string — The address of the smart contract of the payment token that is accepted or offered by the order
      - `quantity` string — The asset quantity of order.
      - `priceBase` number — The price in the base currency of the current chain (Ethereum is converted to eth, bsc is bnb), the unit is ether.
      - `priceUSD` number — The order price in USD.
      - `price` number — The order price in paymentToken, the unit is ether.
      - `standard` string — The order trading Standards.
      - `contractAddress` string — Asset contract address
      - `tokenId` string — Asset token id
      - `schema` string — Asset schema
      - `extra` string — Additional information
      - `exchangeData` string — Additional information
  - `message` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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