Skip to main content
GET
/
v1
/
chains
/
{chain_name}
/
trades
List all trades
curl --request GET \
  --url https://api.sandbox.immutable.com/v1/chains/{chain_name}/trades
{
  "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"
    }
  ]
}

Path Parameters

​
chain_name
string
required

The name of chain

Example:

"imtbl-zkevm-testnet"

Query Parameters

​
account_address
string

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

Example:

"0x784578949A4A50DeA641Fb15dd2B11C72E76919a"

​
sell_item_contract_address
string

Sell item contract address to filter by

Example:

"0x784578949A4A50DeA641Fb15dd2B11C72E76919a"

​
from_indexed_at
string<date-time>

From indexed at including given date

Example:

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

​
page_size
integer<int32>
default:100

Maximum number of trades to return per page Maximum number of items to return

Required range: 1 <= x <= 200
Example:

10

​
sort_by
enum<string>

Trade field to sort by

Available options:
indexed_at
Example:

"indexed_at"

​
sort_direction
enum<string>

Ascending or descending direction for sort

Available options:
asc,
desc
Example:

"asc"

​
page_cursor
string

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

Example:

"ewogICJ0eXBlIjogInByZXYiLAogICJpdGVtIjogewogICAgImlkIjogNjI3NTEzMCwKICAgICJjcmVhdGVkX2F0IjogIjIwMjItMDktMTNUMTc6MDQ6MTIuMDI0MTI2WiIKICB9Cn0="

Response

OK response.

​
page
object
required

Pagination properties

​
result
object[]
required
Maximum array length: 200