---
title: "Query aggregate orders"
method: GET
path: "/openapi/v1/orders/aggregated"
tags: ["Aggregate Orders"]
---

# Query aggregate orders

`GET /openapi/v1/orders/aggregated`

This endpoint can be used to Query Aggregate Orders from multiple markets (Element,OpenSea,LooksRare).You must use the 'v1/orders/fetchExchangeData' API to fetch exchangeData of this order, then use 'exchangeData.erc20Token' to interact with contracts.

## Query parameters

- `contract_address` string, required
- `chain` 'eth' | 'polygon' | 'bsc' | 'avalanche' | 'arbitrum' | 'zksync' | 'linea' | 'opbnb' | 'base' | 'scroll' | 'manta_pacific' | 'optimism' | 'mantle' | 'zkfair' | 'blast' | 'merlin' | 'mode' | 'cyber' | 'bob' | 'lightlink' | 'zeta' | 'nibiru' | 'abstract' | 'bitlayer' | 'mantra' | 'monad' | 'ink', required
- `markets` string[]
- `tokens` string
- `sort_type` 'bestLowToHigh' | 'bestHighToLow' | 'bestListingTime' | 'bestExpiringSoon'
- `direction` string
- `page_index` integer
- `page_size` integer

## Response `200`

OK

- ApiResponseOrdersAggregatedResp
  - `code` integer — Error Code
  - `msg` string — Error Message
  - `data` OrdersAggregatedResp — Return data, Generic
    - `pageSize` integer — Result page size
    - `recordCount` integer — Result record count
    - `currentPage` integer — Result current page index
    - `pageNum` integer — Result total page count
    - `inforList` OrderAggregatedItem[] — Order List
      - `contractAddress` string — Contract Address
      - `tokenId` string — Asset token id
      - `bestAskValid` boolean — When the field is true, bestAskOrder has data, and when it is false, there is no data
      - `bestAskOrder` 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
      - `bestBidValid` boolean — When the field is true, bestBidOrder has data, and when it is false, there is no data
      - `bestBidOrder` 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/revisions/fa83ac7feb23/schema)