Sign in

v1

latestOpenAPI 3.0.32026-07-2659172194.6 KB
orders

List all listings

List all listings

get/v1/chains/{chain_name}/orders/listings

Path parameters

chain_namestring required

The name of chain

Example:imtbl-zkevm-testnet

Query parameters

status'PENDING' | 'ACTIVE' | 'INACTIVE' | 'FILLED' | 'EXPIRED' | 'CANCELLED'

The Order status

Order status to filter by

sell_item_contract_addressstring
Example:0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266

Sell item contract address to filter by

buy_item_type'NATIVE' | 'ERC20'
Example:NATIVE

Buy item type to filter by

buy_item_contract_addressstring
Example:0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266

Buy item contract address to filter by

account_addressstring
Example:0xc49Fd6e51aad88F6F4ce6aB8827279cffFb92266

The account address of the user who created the listing

sell_item_metadata_idstring uuid
Example:020792C9-4AD7-8EC4-4038-9E05C598535B

The metadata_id of the sell item

sell_item_token_idstring
Example:1

Sell item token identifier to filter by

from_updated_atstring date-time
Example:2022-03-09T05:00:50.52Z

From updated at including given date

page_sizeinteger

Maximum number of items to return

Example:10

Maximum number of orders to return per page

sort_by'created_at' | 'updated_at' | 'buy_item_amount'

Order field to sort by

Example:created_at

Order field to sort by. buy_item_amount sorts by per token price, for example if 5 ERC-1155s are on sale for 10eth, it’s sorted as 2eth for buy_item_amount.

sort_direction'asc' | 'desc'

Ascending or descending direction for sort

Example:asc

Ascending or descending direction for sort

page_cursorstring

Encoded page cursor to retrieve previous or next page. Use the value returned in the response.

Example:ewogICJ0eXBlIjogInByZXYiLAogICJpdGVtIjogewogICAgImlkIjogNjI3NTEzMCwKICAgICJjcmVhdGVkX2F0IjogIjIwMjItMDktMTNUMTc6MDQ6MTIuMDI0MTI2WiIKICB9Cn0=

Page cursor to retrieve previous or next page. Use the value returned in the response.

Response

OK response.

Example response

{
  "page": {
    "previous_cursor": "MjAyMy0wMS0yM1QwMTo1NToyNy4zNTM2MzA",
    "next_cursor": "MjAyMy0wMS0yM1QwMTo1NToyNy4zNTM2MzA"
  },
  "result": [
    {
      "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
      "buy": [
        {
          "type": "ERC20",
          "amount": "9750000000000000000",
          "contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
        }
      ],
      "fees": [],
      "chain": {
        "id": "eip155:11155111",
        "name": "sepolia"
      },
      "created_at": "2022-03-07T07:20:50.52Z",
      "end_at": "2022-03-10T05:00:50.52Z",
      "id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
      "order_hash": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
      "protocol_data": {
        "order_type": "FULL_RESTRICTED",
        "counter": "1",
        "zone_address": "0x12",
        "seaport_address": "0x12",
        "seaport_version": "1.5"
      },
      "salt": "12686911856931635052326433555881236148",
      "sell": [
        {
          "type": "ERC721",
          "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
          "token_id": "1"
        }
      ],
      "signature": "0x",
      "start_at": "2022-03-09T05:00:50.52Z",
      "status": {
        "name": "EXPIRED"
      },
      "updated_at": "2022-03-07T07:20:50.52Z"
    },
    {
      "account_address": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
      "buy": [
        {
          "type": "ERC20",
          "amount": "9750000000000000000",
          "contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
        }
      ],
      "fees": [],
      "chain": {
        "id": "eip155:11155111",
        "name": "sepolia"
      },
      "created_at": "2022-03-07T07:20:50.52Z",
      "end_at": "2022-03-10T05:00:50.52Z",
      "id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
      "order_hash": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
      "protocol_data": {
        "order_type": "FULL_RESTRICTED",
        "counter": "1",
        "zone_address": "0x12",
        "seaport_address": "0x12",
        "seaport_version": "1.5"
      },
      "salt": "12686911856931635052326433555881236148",
      "sell": [
        {
          "type": "ERC721",
          "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
          "token_id": "1"
        }
      ],
      "signature": "0x",
      "start_at": "2022-03-09T05:00:50.52Z",
      "status": {
        "name": "EXPIRED"
      },
      "updated_at": "2022-03-07T07:20:50.52Z"
    }
  ]
}