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

# Get token trades from Cryptoslam

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

/v4/data/marketplace/cryptoslam/token/trades

**80 credits per API call**

Returns trades for a specified token address, with optional filtering by side, trader, maker, paired token, 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.
- `tokenAddress` string, required
- `traderAddress` string
- `makerAddress` string
- `pairedTokenAddress` string
- `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
      - `labels` string
    - `trader` object
      - `address` string
    - `maker` object
      - `address` string
    - `sender` object
      - `address` string
      - `name` string
    - `recipient` object
      - `address` string
      - `name` 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.net/tatum/apis/blockchain-data.md) · [All operations](https://skmtc.net/tatum/apis/blockchain-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tatum/blockchain-data/versions/8622ee4b8fae/schema)