Input Schema
{
"method": "GET",
"queryParams": {
"address": {
"description": "Optional filter to only include transfers involving this address",
"type": "string"
},
"blockchain": {
"description": "The blockchain network to query.",
"enum": [
"ethereum",
"base"
],
"required": true,
"type": "string"
},
"direction": {
"description": "Specifies transfer direction relative to address.",
"enum": [
"sent",
"received",
"all"
],
"type": "string"
},
"estimate_cost": {
"description": "When true, returns only the SLAM cost without performing the query",
"type": "boolean"
},
"num": {
"description": "Max number of transfer records to return (max 100)",
"format": "int32",
"type": "integer"
},
"order": {
"description": "Sort order: asc (oldest first) or desc (newest first).",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"start_block": {
"description": "Block number to start 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 from this UTC timestamp (overrides start_block)",
"format": "date-time",
"type": "string"
},
"token_address": {
"description": "ERC-20 token contract address to fetch transfers for.",
"required": true,
"type": "string"
}
},
"type": "http"
}
Output Schema
{
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"properties": {
"chain": {
"description": "Blockchain network name (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": "SLAM token cost for this API call",
"format": "double",
"type": "number"
},
"transfers": {
"description": "List of enriched token transfers with WalletDNA",
"items": {
"properties": {
"amount": {
"properties": {
"decimals": {
"description": "The amount normalized using the token’s decimals",
"format": "double",
"type": "number"
},
"raw": {
"description": "The raw transfer amount (integer or scientific notation)",
"format": "double",
"type": "number"
},
"usd": {
"description": "USD value of the transferred amount at the time of transfer",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"from": {
"properties": {
"address": {
"description": "The wallet address",
"type": "string"
},
"balance": {
"properties": {
"decimals": {
"description": "Token balance normalized to decimals",
"format": "double",
"type": "number"
},
"supply_share": {
"description": "Percentage share of the total token supply at the time of transfer",
"format": "double",
"type": "number"
},
"usd": {
"description": "Value of balance in USD at the time of transfer",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"labels": {
"description": "Labels for the wallet if it is a contract (e.g., 'DeFi', 'DEX')",
"nullable": true,
"type": "string"
},
"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": "Optional display name for contract wallets",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"to": {
"properties": {
"address": {
"description": "The wallet address",
"type": "string"
},
"balance": {
"properties": {
"decimals": {
"description": "Token balance normalized to decimals",
"format": "double",
"type": "number"
},
"supply_share": {
"description": "Percentage share of the total token supply at the time of transfer",
"format": "double",
"type": "number"
},
"usd": {
"description": "Value of balance in USD at the time of transfer",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"labels": {
"description": "Labels for the wallet if it is a contract (e.g., 'DeFi', 'DEX')",
"nullable": true,
"type": "string"
},
"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": "Optional display name for contract wallets",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"token": {
"properties": {
"address": {
"description": "Token contract address",
"type": "string"
},
"fdv": {
"description": "Fully diluted valuation (USD) of the token at the time of transfer",
"format": "double",
"type": "number"
},
"name": {
"description": "Full token name",
"type": "string"
},
"symbol": {
"description": "Token symbol",
"type": "string"
},
"usd": {
"description": "USD price per token unit at the time of transfer",
"format": "double",
"type": "number"
}
},
"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"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
{
"properties": {
"slam": {
"format": "double",
"type": "number"
}
},
"type": "object"
}
]
}
}
},
"description": "OK",
"status": 200
}