v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Marketplace

Get pair trades from Cryptoslam

/v4/data/marketplace/cryptoslam/pair/trades

80 credits per API call

Returns trades for a specified liquidity pool, with optional filtering by side, trader, maker, block range, or timestamp range.

Supported blockchains:

Ethereum - ethereum-mainnet
Base - base-mainnet

get/v4/data/marketplace/cryptoslam/pair/trades

Query parameters

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

Chains supported by the tokens and wallets endpoints.

The blockchain to work with.

pairstring required

Example:0xa1dddb82501e8fe2d92ad0e8ba331313f501de72

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for.

traderAddressstring

Example:0xFd03314B7f38294BA91a51f7A3F716d8Ba36C2bf

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

makerAddressstring

Example:0xfd03314b7f38294ba91a51f7a3f716d8ba36c2bf

Filter trades where this address initiated the swap transaction.

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-21T23:19:35Z

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

startBlockinteger

Example:34513846

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:416

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 name of the blockchain network

Example response

{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 34513846,
    "start_log_index": 416
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-21T23:19:35Z",
        "block": 34514514,
        "hash": "0x4bd2bf862024806b417822818e0f13a348a4ef2365caa95ec9385940ba7408d1",
        "method": "unxswap by order id",
        "log_index": 299
      },
      "side": "sell",
      "usd": 229.823854,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 14460.0574485873
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 193.550073538834
      },
      "price": 0.0134197098315315,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0xFd03314B7f38294BA91a51f7A3F716d8Ba36C2bf"
      },
      "maker": {
        "address": "0xfd03314b7f38294ba91a51f7a3f716d8ba36c2bf"
      },
      "sender": {
        "address": "0x5e2F47bD7D4B357fCfd0Bb224Eb665773B1B9801",
        "name": "Dex Router"
      },
      "recipient": {
        "address": "0x6D5dF1d155d79279ABD65A98815F7853C2b3a005",
        "name": "VIRTUAL/AXR",
        "labels": "Uniswap V2 Pool"
      }
    }
  ]
}