v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Marketplace

Get token trades from Cryptoslam

/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

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

Query parameters

chain'ethereum-mainnet' | 'base-mainnet' required

Chains supported by the tokens and wallets endpoints.

The blockchain to work with.

tokenAddressstring required

Example:0x4200000000000000000000000000000000000006

The ERC-20 token contract address to fetch trades for.

traderAddressstring

Example:0x6Cc3E709499c5E91F65391a017a37f4dEB876142

Filter trades where this address sent or received the specified token, regardless of whether they initiated the swap transaction.

makerAddressstring

Example:0x6cc3e709499c5e91f65391a017a37f4deb876142

Filter trades where this address initiated the swap transaction.

pairedTokenAddressstring

Example:0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870

Filter trades where the specified token was swapped against this paired token address, regardless of pool.

side'buy' | 'sell' | 'all'

Example:sell

Specifies trade side for the implied quote token address.

minUsdnumber

Example:100

Minimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Note: Adds additional SLAM cost to the query.

maxUsdnumber

Example:10000

Maximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Note: Adds additional SLAM cost to the query.

numinteger

Example:25

The maximum number of records to return (1-1000).

order'asc' | 'desc'

Example:desc

Sort order: asc (oldest first) or desc (newest first).

startTimestampstring date-time

Example:2025-08-19T23:34:41Z

Start searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.

startBlockinteger

Example:34428567

Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.

startLogIndexinteger

Example:582

Log index within the starting block to resume pagination or refine the starting point.

estimateCostboolean

When true, returns only the SLAM token cost for this query without performing the actual query.

Response

slamnumber

The SLAM token cost for this API call

chainstring

The blockchain network name

Example response

{
  "slam": 0.156534604543245,
  "chain": "base",
  "cursor": {
    "start_block": 34354914,
    "start_log_index": 951
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-19T23:34:41Z",
        "block": 34428567,
        "hash": "0x5810b16784e796f5ea1c895bc02e83b60af0a72cfaf2ba4db4b06223bc69fe21",
        "log_index": 582
      },
      "side": "sell",
      "usd": 221.269089,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 13391.6083401086
      },
      "base_token": {
        "address": "0x4200000000000000000000000000000000000006",
        "symbol": "WETH",
        "name": "Wrapped Ether",
        "amount": 0.0538745247259804
      },
      "price": 0.00000398083682421022,
      "pair": {
        "address": "0xebab2be57727f0165f4bb35d765377b951100b5f",
        "name": "WETH/VADER",
        "labels": "Uniswap V3 Pool"
      },
      "trader": {
        "address": "0x6Cc3E709499c5E91F65391a017a37f4dEB876142"
      },
      "maker": {
        "address": "0x6cc3e709499c5e91f65391a017a37f4deb876142"
      },
      "sender": {
        "address": "0xf525fF21C370Beb8D9F5C12DC0DA2B583f4b949F",
        "name": "Base Settler"
      },
      "recipient": {
        "address": "0xf525fF21C370Beb8D9F5C12DC0DA2B583f4b949F",
        "name": "Base Settler"
      }
    }
  ]
}