---
title: "Get chain trades from Cryptoslam"
method: GET
path: "/v4/data/marketplace/cryptoslam/chain/trades"
tags: ["Marketplace"]
---

# Get chain trades from Cryptoslam

`GET /v4/data/marketplace/cryptoslam/chain/trades`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v4/data/marketplace/cryptoslam/chain/trades`
- Auth: API key in header `x-api-key`

/v4/data/marketplace/cryptoslam/chain/trades

**100 credits per API call**

Returns trades across the entire blockchain, with optional filtering by block range or timestamp range.

Supported blockchains:

*   Ethereum - ethereum-mainnet
*   Base - base-mainnet

## Query parameters

- `chain` 'ethereum-mainnet' | 'base-mainnet', required: Chains supported by the tokens and wallets endpoints.
- `side` 'buy' | 'sell' | 'all'
- `minUsd` number
- `maxUsd` number
- `num` integer
- `order` 'asc' | 'desc'
- `startTimestamp` string, date-time
- `startBlock` integer
- `startLogIndex` integer
- `estimateCost` boolean

## Response `200`

OK

- object
  - `slam` number: The SLAM token cost for this API call
  - `chain` string: The blockchain network name
  - `cursor` object
    - `start_block` integer: Block number for pagination
    - `start_log_index` integer: Log index for pagination
  - `trades` object[]
    - `transaction` object
      - `utc` string, date-time
      - `block` integer
      - `hash` string
      - `log_index` integer
    - `side` 'buy' | 'sell'
    - `usd` number: Trade size in USD
    - `quote_token` object
      - `address` string
      - `symbol` string
      - `name` string
      - `amount` number
    - `base_token` object
      - `address` string
      - `symbol` string
      - `name` string
      - `amount` number
    - `price` number
    - `pair` object
      - `address` string
      - `name` string
    - `trader` object
      - `address` string
    - `maker` object
      - `address` string
    - `sender` object
      - `address` string
      - `name` string
      - `labels` string
    - `recipient` object
      - `address` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/blockchain-data.md) - [All operations](https://skmtc.dev/tatum/apis/blockchain-data/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/blockchain-data/revisions/1a87afa0f639?raw)