---
updatedAt: 2026-08-21T07:48:44.000Z
agentTools:
projectIndex: https://docs.tatum.io/llms.txt
---
# 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
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"servers": [
{
"url": "https://api.tatum.io"
}
],
"info": {
"version": "1.2",
"title": "Blockchain Data"
},
"tags": [
{
"name": "Marketplace"
}
],
"paths": {
"/v4/data/marketplace/cryptoslam/wallet/trades": {
"get": {
"description": "/v4/data/marketplace/cryptoslam/wallet/trades
\n80 credits per API call
\n\nReturns 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.
\n\nSupported blockchains:
\n\n- Ethereum - ethereum-mainnet
\n- Base - base-mainnet
\n
\n",
"operationId": "GetCryptoslamWalletTrades",
"parameters": [
{
"description": "The blockchain to work with.",
"in": "query",
"name": "chain",
"required": true,
"schema": {
"$ref": "#/components/schemas/ChainEnumForTrendingTokens"
}
},
{
"description": "The wallet address to fetch trades for.",
"in": "query",
"name": "walletAddress",
"required": true,
"schema": {
"type": "string",
"example": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388"
}
},
{
"description": "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.",
"in": "query",
"name": "walletRole",
"required": false,
"schema": {
"type": "string",
"enum": [
"trader",
"maker"
],
"default": "trader",
"example": "trader"
}
},
{
"description": "The ERC-20 token contract address to fetch trades for.",
"in": "query",
"name": "tokenAddress",
"required": false,
"schema": {
"type": "string",
"example": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870"
}
},
{
"description": "Filter trades where the specified token was swapped against this paired token address, regardless of pool.",
"in": "query",
"name": "pairedTokenAddress",
"required": false,
"schema": {
"type": "string",
"example": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b"
}
},
{
"description": "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.",
"in": "query",
"name": "pair",
"required": false,
"schema": {
"type": "string",
"example": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72"
}
},
{
"description": "Specifies trade side for the given token_address.",
"in": "query",
"name": "side",
"required": false,
"schema": {
"type": "string",
"enum": [
"buy",
"sell",
"all"
],
"default": "all",
"example": "sell"
}
},
{
"description": "Minimum trade size in USD. Filters out trades with an estimated USD value below this threshold.\nNote: Adds additional SLAM cost to the query.\n",
"in": "query",
"name": "minUsd",
"required": false,
"schema": {
"type": "number",
"example": 100
}
},
{
"description": "Maximum trade size in USD. Filters out trades with an estimated USD value above this threshold.\nNote: Adds additional SLAM cost to the query.\n",
"in": "query",
"name": "maxUsd",
"required": false,
"schema": {
"type": "number",
"example": 10000
}
},
{
"description": "The maximum number of records to return (1-1000).",
"in": "query",
"name": "num",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"default": 25,
"example": 25
}
},
{
"description": "Sort order: asc (oldest first) or desc (newest first).",
"in": "query",
"name": "order",
"required": false,
"schema": {
"type": "string",
"enum": [
"asc",
"desc"
],
"default": "desc",
"example": "desc"
}
},
{
"description": "Start searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.",
"in": "query",
"name": "startTimestamp",
"required": false,
"schema": {
"type": "string",
"format": "date-time",
"example": "2025-08-18T06:46:35Z"
}
},
{
"description": "Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.",
"in": "query",
"name": "startBlock",
"required": false,
"schema": {
"type": "integer",
"example": 34355124
}
},
{
"description": "Log index within the starting block to resume pagination or refine the starting point.",
"in": "query",
"name": "startLogIndex",
"required": false,
"schema": {
"type": "integer",
"example": 582
}
},
{
"description": "When true, returns only the SLAM token cost for this query without performing the actual query.",
"in": "query",
"name": "estimateCost",
"required": false,
"schema": {
"type": "boolean",
"default": false
}
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"slam": {
"type": "number",
"description": "The SLAM token cost for this API call",
"example": 0.065
},
"chain": {
"type": "string",
"description": "The name of the blockchain network",
"example": "base"
},
"cursor": {
"type": "object",
"properties": {
"start_block": {
"type": "integer",
"description": "Block number for pagination",
"example": 31384774
},
"start_log_index": {
"type": "integer",
"description": "Log index for pagination",
"example": 45
}
}
},
"trades": {
"type": "array",
"items": {
"type": "object",
"properties": {
"transaction": {
"type": "object",
"properties": {
"utc": {
"type": "string",
"format": "date-time",
"example": "2025-08-18T06:46:35Z"
},
"block": {
"type": "integer",
"example": 34355124
},
"hash": {
"type": "string",
"example": "0x09c715d8f2c16134119d9cc53a600a09b49d1fa20dcc6cc1a8c02b4a86439d51"
},
"method": {
"type": "string",
"example": "swap simple mode"
},
"log_index": {
"type": "integer",
"example": 582
}
}
},
"side": {
"type": "string",
"enum": [
"buy",
"sell"
],
"example": "sell"
},
"usd": {
"type": "number",
"description": "Trade size in USD",
"example": 10726.204254
},
"quote_token": {
"type": "object",
"properties": {
"address": {
"type": "string",
"example": "0x731814e491571a2e9ee3c5b1f7f3b962ee8f4870"
},
"symbol": {
"type": "string",
"example": "VADER"
},
"name": {
"type": "string",
"example": "VaderAI by Virtuals"
},
"amount": {
"type": "number",
"example": 618854.223280559
}
}
},
"base_token": {
"type": "object",
"properties": {
"address": {
"type": "string",
"example": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b"
},
"symbol": {
"type": "string",
"example": "VIRTUAL"
},
"name": {
"type": "string",
"example": "Virtual Protocol"
},
"amount": {
"type": "number",
"example": 8899.78611752252
}
}
},
"price": {
"type": "number",
"example": 0.0141539462344898
},
"pair": {
"type": "object",
"properties": {
"address": {
"type": "string",
"example": "0xa1dddb82501e8fe2d92ad0e8ba331313f501de72"
},
"name": {
"type": "string",
"example": "VIRTUAL/VADER"
},
"labels": {
"type": "string",
"example": "Uniswap V2 Pool"
}
}
},
"trader": {
"type": "object",
"properties": {
"address": {
"type": "string",
"example": "0x45D964A0E60e45a5144Dc2d2273503B01f83D388"
}
}
},
"maker": {
"type": "object",
"properties": {
"address": {
"type": "string",
"example": "0x45d964a0e60e45a5144dc2d2273503b01f83d388"
}
}
},
"sender": {
"type": "object",
"properties": {
"address": {
"type": "string",
"example": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
}
}
},
"recipient": {
"type": "object",
"properties": {
"address": {
"type": "string",
"example": "0x6E4141d33021b52C91c28608403db4A0FFB50Ec6"
}
}
}
}
}
}
},
"example": {
"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"
}
}
]
}
}
}
}
},
"400": {
"$ref": "#/components/responses/Error400"
},
"401": {
"$ref": "#/components/responses/Error401"
},
"403": {
"$ref": "#/components/responses/Error403"
},
"500": {
"$ref": "#/components/responses/Error500"
}
},
"security": [
{
"X-API-Key": []
}
],
"x-codeSamples": [],
"summary": "Get wallet trades from Cryptoslam",
"tags": [
"Marketplace"
]
}
}
},
"components": {
"securitySchemes": {
"X-API-Key": {
"type": "apiKey",
"name": "x-api-key",
"in": "header",
"description": "Your **API key** is used to identify your account & your plan, including the number of API calls per second and total monthly calls you have.\n\nEach key is for individual use only.\n\nIf you don't have a key already you can [Sign up for a Free Tatum account](https://co.tatum.io/signup) to get two keys (testnet and mainnet), allowing up to 5 API calls per second and 1,000,000 Credits.\n\nFor testing purposes, you can use the following key which only works inside docs and has limited functionality (e.g. you cannot create virtual accounts or notification subscriptions with it):\n* t-66a730ccccfd17001c479705-2f597d14ad7543f289a03418\n\nFor more details on limits and plans, [click here](https://docs.tatum.io/docs/plans-limits).\n"
}
},
"responses": {
"Error400": {
"description": "Bad Request",
"content": {
"application/json": {
"schema": {
"properties": {
"errorCode": {
"example": "validation.failed",
"description": "validation.failed",
"type": "string"
},
"message": {
"example": "Request validation failed. Please see data for additional information.",
"description": "Request validation failed. Please see data for additional information.",
"type": "string"
},
"statusCode": {
"example": 400,
"description": "400",
"type": "number"
},
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"target"
],
"properties": {
"target": {
"type": "object",
"additionalProperties": true,
"description": "Request object present in the body of the HTTP request",
"example": {
"property": 12345
}
},
"value": {
"type": "number",
"description": "Value of the target object which validation is wrong. Can be of any data type, example here is using type number.",
"example": 12345
},
"property": {
"type": "string",
"description": "Property name of the target object which validation is wrong",
"example": "property1"
},
"constraints": {
"type": "object",
"additionalProperties": true,
"description": "Object of failed constraints for the target object. Key is the constraint, value is detailed description of the failed constraint.",
"example": {
"min": "property1 must not be less than 50000"
}
}
}
}
}
},
"required": [
"errorCode",
"message",
"statusCode",
"data"
],
"type": "object"
}
}
}
},
"Error401": {
"description": "Unauthorized. Not valid or inactive subscription key present in the HTTP Header.",
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"properties": {
"errorCode": {
"example": "subscription.not.active",
"description": "subscription.not.active",
"type": "string"
},
"message": {
"example": "Subscription not active anymore.",
"description": "Subscription not active anymore.",
"type": "string"
},
"statusCode": {
"example": 401,
"description": "401",
"type": "number"
}
},
"required": [
"errorCode",
"message",
"statusCode"
],
"type": "object"
},
{
"properties": {
"errorCode": {
"example": "subscription.invalid",
"description": "subscription.invalid",
"type": "string"
},
"message": {
"example": "Unable to find valid subscription for '${apiKey}'",
"description": "Unable to find valid subscription for '${apiKey}'",
"type": "string"
},
"statusCode": {
"example": 401,
"description": "401",
"type": "number"
}
},
"required": [
"errorCode",
"message",
"statusCode"
],
"type": "object"
}
]
}
}
}
},
"Error403": {
"description": "Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.",
"content": {
"application/json": {
"schema": {
"properties": {
"message": {
"example": "Forbidden",
"description": "Forbidden",
"type": "string"
},
"statusCode": {
"example": 403,
"description": "403",
"type": "number"
}
},
"required": [
"statusCode",
"message"
],
"type": "object"
}
}
}
},
"Error500": {
"description": "Internal server error. There was an error on the server during the processing of the request.",
"content": {
"application/json": {
"schema": {
"properties": {
"message": {
"example": "Internal server error",
"description": "Internal server error",
"type": "string"
},
"statusCode": {
"example": 500,
"description": "500",
"type": "number"
}
},
"required": [
"statusCode",
"message"
],
"type": "object"
}
}
}
}
},
"schemas": {
"ChainEnumForTrendingTokens": {
"type": "string",
"description": "Chains supported by the tokens and wallets endpoints.\n",
"enum": [
"ethereum-mainnet",
"base-mainnet"
]
}
}
}
}
```