Input Schema
{
"method": "GET",
"queryParams": {
"blockchain": {
"description": "The blockchain network to query.",
"enum": [
"ethereum",
"base"
],
"required": true,
"type": "string"
},
"estimate_cost": {
"description": "When true returns the SLAM token cost for this query. It does not return any data or incur any actual charges.",
"type": "boolean"
},
"max_usd": {
"description": "Maximum trade size in USD. Filters out trades with an estimated USD value above this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.",
"format": "double",
"type": "number"
},
"min_usd": {
"description": "Minimum trade size in USD. Filters out trades with an estimated USD value below this threshold. Calculated using on-chain price data at the time of the trade. Note: Adds additional SLAM cost to the query. A maximum of 10,000 trades that would otherwise match this query will be scanned.",
"format": "double",
"type": "number"
},
"num": {
"description": "The maximum number of records to return.",
"format": "int32",
"type": "integer"
},
"order": {
"description": "Sort order: asc (oldest first) or desc (newest first).",
"type": "string"
},
"pair": {
"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.",
"type": "string"
},
"paired_token_address": {
"description": "Filter trades where the specified token was swapped against this paired token address, regardless of pool.",
"type": "string"
},
"side": {
"description": "Specifies trade side for the given token_address.",
"enum": [
"buy",
"sell",
"all"
],
"type": "string"
},
"start_block": {
"description": "Block number to start the search from (inclusive). Defaults to the latest block in desc order, or the genesis block in asc order.",
"format": "int32",
"type": "integer"
},
"start_log_index": {
"description": "Log index within the starting block to resume pagination or refine the starting point.",
"format": "int32",
"type": "integer"
},
"start_timestamp": {
"description": "Start searching from this UTC timestamp (inclusive). If provided, overrides start_block as the starting point.",
"format": "date-time",
"type": "string"
},
"token_address": {
"description": "The ERC-20 token contract address to fetch trades for.",
"type": "string"
},
"wallet_address": {
"description": "The wallet address to fetch trades for.",
"required": true,
"type": "string"
},
"wallet_role": {
"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.",
"enum": [
"trader",
"maker"
],
"type": "string"
}
},
"type": "http"
}
Output Schema
{
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"properties": {
"chain": {
"description": "The name of the blockchain network (e.g., base).",
"type": "string"
},
"cursor": {
"properties": {
"start_block": {
"description": "The block number at which to continue fetching results.",
"format": "int32",
"type": "integer"
},
"start_log_index": {
"description": "The log index within the block at which to continue.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"slam": {
"description": "The SLAM token cost for this API call.",
"format": "double",
"type": "number"
},
"trades": {
"description": "List of token trade records matching the query.",
"items": {
"properties": {
"base_token": {
"properties": {
"address": {
"description": "Token contract address.",
"type": "string"
},
"amount": {
"description": "The amount of the token exchanged (normalized by token decimals).",
"format": "double",
"type": "number"
},
"name": {
"description": "Full token name.",
"type": "string"
},
"symbol": {
"description": "Token symbol.",
"type": "string"
}
},
"type": "object"
},
"maker": {
"properties": {
"address": {
"description": "The maker address.",
"type": "string"
},
"labels": {
"description": "Additional tags or labels describing the address.",
"nullable": true,
"type": "string"
},
"name": {
"description": "A human-readable label for the address (if available).",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"pair": {
"properties": {
"address": {
"description": "The pair or pool contract address (V2/V3) or pool ID (V4).",
"type": "string"
},
"labels": {
"description": "Additional tags or labels describing the pair.",
"nullable": true,
"type": "string"
},
"name": {
"description": "Pair name (e.g., WETH/USDC).",
"type": "string"
}
},
"type": "object"
},
"price": {
"description": "The execution price expressed as quoteToken per baseToken.",
"format": "double",
"type": "number"
},
"quote_token": {
"properties": {
"address": {
"description": "Token contract address.",
"type": "string"
},
"amount": {
"description": "The amount of the token exchanged (normalized by token decimals).",
"format": "double",
"type": "number"
},
"name": {
"description": "Full token name.",
"type": "string"
},
"symbol": {
"description": "Token symbol.",
"type": "string"
}
},
"type": "object"
},
"recipient": {
"properties": {
"address": {
"description": "The address designated to receive output tokens in the swap event (Uniswap V2: event to; Uniswap V3: event recipient). May be an intermediary contract.",
"type": "string"
},
"labels": {
"description": "Additional tags or labels describing the address.",
"nullable": true,
"type": "string"
},
"name": {
"description": "A human-readable label for the address (if available).",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"sender": {
"properties": {
"address": {
"description": "The address that invoked the pool’s swap function (event sender); often a router, aggregator, or other contract executing the swap.",
"type": "string"
},
"labels": {
"description": "Additional tags or labels describing the address.",
"nullable": true,
"type": "string"
},
"name": {
"description": "A human-readable label for the address (if available).",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"side": {
"description": "The side of the trade: \"buy\" or \"sell\", relative to the trader.",
"type": "string"
},
"trader": {
"properties": {
"address": {
"description": "The trader address.",
"type": "string"
},
"base_token_holding": {
"properties": {
"balance": {
"description": "Current wallet balance of the token.",
"format": "double",
"type": "number"
},
"held": {
"description": "Amount held (non-staked).",
"format": "double",
"nullable": true,
"type": "number"
},
"staked": {
"description": "Net amount transferred to a staking contract.",
"format": "double",
"nullable": true,
"type": "number"
},
"staked_pct": {
"description": "Percentage of the wallet's token balance transferred to a staking contract.",
"format": "double",
"nullable": true,
"type": "number"
},
"supply_pct": {
"description": "Percentage of the token's total supply held.",
"format": "double",
"type": "number"
},
"value_usd": {
"description": "USD value of the token holdings.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"entry": {
"properties": {
"block": {
"description": "Block number of entry.",
"format": "int32",
"type": "integer"
},
"grand_parent": {
"description": "Address of the upstream source two levels back in the transfer chain.",
"nullable": true,
"type": "string"
},
"great_grand_parent": {
"description": "Address of the upstream source three levels back in the transfer chain.",
"nullable": true,
"type": "string"
},
"method": {
"description": "How the wallet initially received the token (e.g., \"DEX\", \"Airdrop\", \"Transfer\")",
"type": "string"
},
"parent": {
"description": "Address of the immediate parent wallet/contract that transferred tokens to this wallet.",
"nullable": true,
"type": "string"
},
"token_amount": {
"description": "Amount received at entry.",
"format": "double",
"type": "number"
},
"utc": {
"description": "Timestamp of entry (ISO 8601 format).",
"type": "string"
}
},
"type": "object"
},
"epoch": {
"properties": {
"raw": {
"description": "Raw epoch score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Epoch tier (e.g., \"Early Adopter\")",
"type": "string"
}
},
"type": "object"
},
"flow": {
"properties": {
"buy": {
"properties": {
"raw": {
"description": "Raw flow score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Flow tier (e.g., \"Flood\")",
"type": "string"
}
},
"type": "object"
},
"sell": {
"properties": {
"raw": {
"description": "Raw flow score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Flow tier (e.g., \"Flood\")",
"type": "string"
}
},
"type": "object"
},
"total": {
"properties": {
"raw": {
"description": "Raw flow score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Flow tier (e.g., \"Flood\")",
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"intelligence": {
"properties": {
"iq": {
"description": "Raw IQ score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Intelligence label (e.g., \"Genius\")",
"type": "string"
}
},
"type": "object"
},
"labels": {
"description": "Additional tags or labels describing the address.",
"nullable": true,
"type": "string"
},
"maker_presence": {
"properties": {
"raw": {
"description": "Raw presence score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Presence tier (e.g., \"Active\")",
"type": "string"
}
},
"type": "object"
},
"mass": {
"properties": {
"raw": {
"description": "Raw mass score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Mass tier (e.g., \"Whale\", \"Dolphin\", \"Fish\", etc.)",
"type": "string"
}
},
"type": "object"
},
"name": {
"description": "A human-readable label for the address (if available).",
"nullable": true,
"type": "string"
},
"quote_token_holding": {
"properties": {
"balance": {
"description": "Current wallet balance of the token.",
"format": "double",
"type": "number"
},
"held": {
"description": "Amount held (non-staked).",
"format": "double",
"nullable": true,
"type": "number"
},
"staked": {
"description": "Net amount transferred to a staking contract.",
"format": "double",
"nullable": true,
"type": "number"
},
"staked_pct": {
"description": "Percentage of the wallet's token balance transferred to a staking contract.",
"format": "double",
"nullable": true,
"type": "number"
},
"supply_pct": {
"description": "Percentage of the token's total supply held.",
"format": "double",
"type": "number"
},
"value_usd": {
"description": "USD value of the token holdings.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"reputation": {
"properties": {
"raw": {
"description": "Raw reputation score.",
"format": "double",
"nullable": true,
"type": "number"
},
"tier": {
"description": "Reputation label (e.g., \"A\")",
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"transaction": {
"properties": {
"block": {
"description": "Block number containing the transaction.",
"format": "int32",
"type": "integer"
},
"hash": {
"description": "Transaction hash.",
"type": "string"
},
"log_index": {
"description": "Log index for this transfer within the block.",
"format": "int32",
"type": "integer"
},
"method": {
"description": "Decoded contract method name (if available).",
"nullable": true,
"type": "string"
},
"utc": {
"description": "UTC timestamp of the transaction (ISO 8601 format).",
"type": "string"
}
},
"type": "object"
},
"usd": {
"description": "The USD value of the trade at the time of execution.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
{
"properties": {
"slam": {
"format": "double",
"type": "number"
}
},
"type": "object"
}
]
}
}
},
"description": "OK",
"status": 200
}