---
title: "List all trades"
method: GET
path: "/v1/chains/{chain_name}/trades"
tags: ["orders"]
---

# List all trades

`GET /v1/chains/{chain_name}/trades`

List all trades

## Path parameters

- `chain_name` string, required — The name of chain

## Query parameters

- `account_address` string — Account address to filter trades by (includes buy and sell wallet address)
- `sell_item_contract_address` string — Sell item contract address to filter by
- `from_indexed_at` string, date-time
- `page_size` integer — Maximum number of items to return
- `sort_by` 'indexed_at' — Trade field to sort by
- `sort_direction` 'asc' | 'desc' — Ascending or descending direction for sort
- `page_cursor` string — Encoded page cursor to retrieve previous or next page. Use the value returned in the response.

## Response `200`

OK response.

- ListTradeResult
  - `page` Page, required — Pagination properties
    - `previous_cursor` string, nullable, required — First item as an encoded string
    - `next_cursor` string, nullable, required — Last item as an encoded string
  - `result` Trade[], required
    - `buy` Item[], required — Buy items are transferred from the taker to the maker.
      - union
        - NativeItem
          - `type` 'NATIVE', required — Token type user is offering, which in this case is the native IMX token
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC20Item
          - `type` 'ERC20', required — Token type user is offering, which in this case is ERC20
          - `contract_address` string, required — Address of ERC20 token
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC721Item
          - `type` 'ERC721', required — Token type user is offering, which in this case is ERC721
          - `contract_address` string, required — Address of ERC721 token
          - `token_id` string, required — ID of ERC721 token
        - ERC1155Item
          - `type` 'ERC1155', required — Token type user is offering, which in this case is ERC1155
          - `contract_address` string, required — Address of ERC1155 token
          - `token_id` string, required — ID of ERC1155 token
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC721CollectionItem
          - `type` 'ERC721_COLLECTION', required — Token type user is offering, which in this case is ERC721
          - `contract_address` string, required — Address of ERC721 collection
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC1155CollectionItem
          - `type` 'ERC1155_COLLECTION', required — Token type user is offering, which in this case is ERC1155
          - `contract_address` string, required — Address of ERC1155 collection
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
    - `buyer_address` string, required — Deprecated. Use maker and taker addresses instead of buyer and seller addresses.
    - `buyer_fees` Fee[], required — Deprecated. Use fees instead. The taker always pays the fees.
      - `amount` string, required — Fee payable to recipient upon settlement
      - `type` 'ROYALTY' | 'MAKER_ECOSYSTEM' | 'TAKER_ECOSYSTEM' | 'PROTOCOL', required — Fee type
      - `recipient_address` string, required — Wallet address of fee recipient
    - `fees` Fee[], required
      - `amount` string, required — Fee payable to recipient upon settlement
      - `type` 'ROYALTY' | 'MAKER_ECOSYSTEM' | 'TAKER_ECOSYSTEM' | 'PROTOCOL', required — Fee type
      - `recipient_address` string, required — Wallet address of fee recipient
    - `chain` Chain, required — The chain details
      - `id` string, required — The id of chain
      - `name` string, required — The name of chain
    - `order_id` string, required
    - `blockchain_metadata` TradeBlockchainMetadata, nullable, required — The metadata related to the transaction in which the activity occurred
      - `transaction_hash` string, required — The transaction hash of the trade
      - `block_number` string, required — EVM block number (uint64 as string)
      - `transaction_index` string, required — Transaction index in a block (uint32 as string)
      - `log_index` string, required — The log index of the fulfillment event in a block (uint32 as string)
    - `indexed_at` string, date-time, required — Time the on-chain trade event is indexed by the order book system
    - `id` string, required — Global Trade identifier
    - `sell` Item[], required — Sell items are transferred from the maker to the taker.
      - union
        - NativeItem
          - `type` 'NATIVE', required — Token type user is offering, which in this case is the native IMX token
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC20Item
          - `type` 'ERC20', required — Token type user is offering, which in this case is ERC20
          - `contract_address` string, required — Address of ERC20 token
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC721Item
          - `type` 'ERC721', required — Token type user is offering, which in this case is ERC721
          - `contract_address` string, required — Address of ERC721 token
          - `token_id` string, required — ID of ERC721 token
        - ERC1155Item
          - `type` 'ERC1155', required — Token type user is offering, which in this case is ERC1155
          - `contract_address` string, required — Address of ERC1155 token
          - `token_id` string, required — ID of ERC1155 token
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC721CollectionItem
          - `type` 'ERC721_COLLECTION', required — Token type user is offering, which in this case is ERC721
          - `contract_address` string, required — Address of ERC721 collection
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
        - ERC1155CollectionItem
          - `type` 'ERC1155_COLLECTION', required — Token type user is offering, which in this case is ERC1155
          - `contract_address` string, required — Address of ERC1155 collection
          - `amount` string, required — A string representing the price at which the user is willing to sell the token. This value is provided in the smallest unit of the token (e.g., wei for Ethereum).
    - `seller_address` string, required — Deprecated. Use maker and taker addresses instead of buyer and seller addresses.
    - `maker_address` string, required
    - `taker_address` string, required

## Other responses

- `400` — Bad Request (400)
- `404` — The specified resource was not found (404)
- `500` — Internal Server Error (500)

---

[API](https://skmtc.dev/immutable/apis/immutable-zkevm-api.md) · [All operations](https://skmtc.dev/immutable/apis/immutable-zkevm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/immutable/immutable-zkevm-api/revisions/59f94155fcd0/schema)