Sign in

v1

latestOpenAPI 3.0.12026-07-142791104.2 KB
Aggregate Orders

Query aggregate orders

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.

get/openapi/v1/orders/aggregated

Query parameters

contract_addressstring required

The contract address for query

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

Chain name, which the asset belongs, Supported chains: eth, polygon, bsc, avalanche, arbitrum, zksync, linea, starknet, opbnb, base, scroll, manta_pacific, optimism, mantle, zkfair, blast, merlin, mode, cyber, bob, lightlink,zeta,nibiru,abstract,bitlayer,mantra. eth is default

marketsstring[]

Filter by the market, support markets: element, opensea, looksrare. empty for all market.

tokensstring

Filter by the asset token ids, comma separated.

sort_type'bestLowToHigh' | 'bestHighToLow' | 'bestListingTime' | 'bestExpiringSoon'

Sort type for the result. bestLowToHigh is default.

directionstring

Support -asc (positive order) desc (reverse order) default desc.

page_indexinteger

Result page index, from 1

page_sizeinteger

Result page size, max 50, 20 for default.

Response

OK

codeinteger

Error Code

msgstring

Error Message

messagestring

Example response

{
  "data": {
    "pageSize": 1,
    "recordCount": 1,
    "currentPage": 1,
    "pageNum": 1,
    "inforList": [
      {
        "contractAddress": "0xba592c7d486226af95569c565f6c73cbcb5778a2",
        "tokenId": "19",
        "bestAskValid": true,
        "bestAskOrder": {
          "chain": "eth",
          "chainId": "0x1",
          "orderHash": "0x99a2d68bda1a946dc71f1b45b59f173d592382c2fc5b4cc87c350e9e0d19a001",
          "orderId": "974967556489302561",
          "expirationTime": 1668136793,
          "listingTime": 1667531933,
          "createTime": 1667531999,
          "maker": "0xea199722372dea9df458dbb56be7721af117a9bc",
          "taker": "0x0000000000000000000000000000000000000000",
          "side": 1,
          "paymentToken": "0x0000000000000000000000000000000000000000",
          "quantity": "1",
          "priceBase": 0.2,
          "priceUSD": 309.7634,
          "price": 0.2,
          "standard": "element-ex-v3",
          "contractAddress": "0x5fecbbbaf9f3126043a48a35eb2eb8667d469d53",
          "tokenId": "177004",
          "schema": "ERC721",
          "extra": "0",
          "exchangeData": "0"
        },
        "bestBidValid": true,
        "bestBidOrder": {
          "chain": "eth",
          "chainId": "0x1",
          "orderHash": "0x99a2d68bda1a946dc71f1b45b59f173d592382c2fc5b4cc87c350e9e0d19a001",
          "orderId": "974967556489302561",
          "expirationTime": 1668136793,
          "listingTime": 1667531933,
          "createTime": 1667531999,
          "maker": "0xea199722372dea9df458dbb56be7721af117a9bc",
          "taker": "0x0000000000000000000000000000000000000000",
          "side": 1,
          "paymentToken": "0x0000000000000000000000000000000000000000",
          "quantity": "1",
          "priceBase": 0.2,
          "priceUSD": 309.7634,
          "price": 0.2,
          "standard": "element-ex-v3",
          "contractAddress": "0x5fecbbbaf9f3126043a48a35eb2eb8667d469d53",
          "tokenId": "177004",
          "schema": "ERC721",
          "extra": "0",
          "exchangeData": "0"
        }
      }
    ]
  }
}