v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

Marketplace

Get wallet trades from Cryptoslam

/v4/data/marketplace/cryptoslam/wallet/trades

80 credits per API call

Returns trades for a specified wallet address as the trader (default) or maker, with optional filtering by token, paired token, pair, side, block range, or timestamp range.

Supported blockchains:

Ethereum - ethereum-mainnet
Base - base-mainnet

get/v4/data/marketplace/cryptoslam/wallet/trades

Query parameters

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

Chains supported by the tokens and wallets endpoints.

The blockchain to work with.

walletAddressstring required

Example:0x45D964A0E60e45a5144Dc2d2273503B01f83D388

The wallet address to fetch trades for.

walletRole'trader' | 'maker'

Example:trader

Filter trades where the specified wallet_address acted in the given role. Trader (default) where the wallet sent or received the token, regardless of initiating the swap transaction, or maker where the wallet initiated the swap transaction.

tokenAddressstring

Example:0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870

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

pairedTokenAddressstring

Example:0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b

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

pairstring

Example:0xa1dddb82501e8fe2d92ad0e8ba331313f501de72

The contract address (Uniswap V2/V3) or pool ID (Uniswap V4) of the liquidity pool to fetch trades for. When present, overrides token_address and paired_token_address.

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

Example:sell

Specifies trade side for the given 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-18T06:46:35Z

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

startBlockinteger

Example:34355124

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

Example response

{
  "slam": 0.065,
  "chain": "base",
  "cursor": {
    "start_block": 31384774,
    "start_log_index": 45
  },
  "trades": [
    {
      "transaction": {
        "utc": "2025-08-18T06:46:35Z",
        "block": 34355124,
        "hash": "0x09c715d8f2c16134119d9cc53a600a09b49d1fa20dcc6cc1a8c02b4a86439d51",
        "method": "swap simple mode",
        "log_index": 582
      },
      "side": "sell",
      "usd": 10726.204254,
      "quote_token": {
        "address": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870",
        "symbol": "VADER",
        "name": "VaderAI by Virtuals",
        "amount": 618854.223280559
      },
      "base_token": {
        "address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
        "symbol": "VIRTUAL",
        "name": "Virtual Protocol",
        "amount": 8899.78611752252
      },
      "price": 0.0141539462344898,
      "pair": {
        "address": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72",
        "name": "VIRTUAL/VADER",
        "labels": "Uniswap V2 Pool"
      },
      "trader": {
        "address": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388"
      },
      "maker": {
        "address": "0x45d964a0e60e45a5144dc2d2273503b01f83d388"
      },
      "sender": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      },
      "recipient": {
        "address": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
      }
    }
  ]
}