v1

latestOpenAPI 3.0.32026-07-2659172194.6 KB

orders

List all trades

get/v1/chains/{chain_name}/trades

Path parameters

chain_namestring required

The name of chain

Example:imtbl-zkevm-testnet

Query parameters

account_addressstring

Account address to filter trades by (includes buy and sell wallet address)

Example:0x784578949A4A50DeA641Fb15dd2B11C72E76919a

sell_item_contract_addressstring

Sell item contract address to filter by

Example:0x784578949A4A50DeA641Fb15dd2B11C72E76919a

from_indexed_atstring date-time

Example:2022-03-09T05:00:50.52Z

From indexed at including given date

page_sizeinteger

Maximum number of items to return

Example:10

Maximum number of trades to return per page

sort_by'indexed_at'

Trade field to sort by

Example:indexed_at

Trade field to sort by

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": [
    {
      "buy": [
        {
          "type": "ERC20",
          "amount": "9750000000000000000",
          "contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
        }
      ],
      "buyer_address": "0xFC99a706C0D05B8C71E1fAAC91b3E1343aC34D40",
      "buyer_fees": [],
      "chain": {
        "id": "eip155:11155111",
        "name": "sepolia"
      },
      "created_at": "2022-03-07T07:20:50.52Z",
      "id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
      "sell": [
        {
          "type": "ERC721",
          "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
          "token_id": "1"
        }
      ],
      "seller_address": "0x002b9B1cbf464782Df5d48870358FA6c09f1b19D",
      "maker_address": "0x002b9B1cbf464782Df5d48870358FA6c09f1b19D",
      "taker_address": "0xFC99a706C0D05B8C71E1fAAC91b3E1343aC34D40",
      "updated_at": "2022-03-07T07:20:50.52Z"
    },
    {
      "buy": [
        {
          "type": "ERC20",
          "amount": "9750000000000000000",
          "contract_address": "0x0165878A594ca255338adfa4d48449f69242Eb8F"
        }
      ],
      "buyer_address": "0x017406f3F27d507a1491976B7835CE5CD0fA647a",
      "buyer_fees": [],
      "chain": {
        "id": "eip155:11155111",
        "name": "sepolia"
      },
      "created_at": "2022-03-07T07:20:50.52Z",
      "id": "018792C9-4AD7-8EC4-4038-9E05C598534A",
      "sell": [
        {
          "type": "ERC721",
          "contract_address": "0x692edAd005237c7E737bB2c0F3D8ccCc10D3479E",
          "token_id": "1"
        }
      ],
      "seller_address": "0xC73349c545C1D757eb650cDc463A2f6dF1Ec41cb",
      "maker_address": "0xC73349c545C1D757eb650cDc463A2f6dF1Ec41cb",
      "taker_address": "0x017406f3F27d507a1491976B7835CE5CD0fA647a",
      "updated_at": "2022-03-07T07:20:50.52Z"
    }
  ]
}