Input Schema
{
"method": "GET",
"queryParams": {
"address": {
"description": "Filter transfers where this address is either the sender or the receiver.",
"type": "string"
},
"blockchain": {
"description": "The blockchain to query",
"enum": [
"ethereum",
"base"
],
"required": true,
"type": "string"
},
"direction": {
"description": "Transfer direction relative to the address.",
"enum": [
"sent",
"received",
"all"
],
"type": "string"
},
"estimate_cost": {
"description": "When true, returns only the SLAM token cost for this query.",
"type": "boolean"
},
"num": {
"description": "The maximum number of transfer records to return (1-1000).",
"format": "int32",
"type": "integer"
},
"order": {
"description": "Sort order for results: 'asc' (oldest first) or 'desc' (newest first).",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"start_block": {
"description": "Block number to start the search from (inclusive).",
"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). Overrides start_block when provided.",
"format": "date-time",
"type": "string"
},
"token_address": {
"description": "The ERC-20 token contract address to fetch transfers for.",
"type": "string"
},
"wallet_address": {
"description": "The wallet address to fetch transfers for. (Required)",
"type": "string"
}
},
"type": "http"
}
Output Schema
{
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"properties": {
"chain": {
"description": "The 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": "The SLAM token cost for this API call.",
"format": "double",
"type": "number"
},
"transfers": {
"description": "List of token transfer records matching the query.",
"items": {
"properties": {
"amount": {
"properties": {
"decimals": {
"description": "Normalized amount using token’s decimals.",
"format": "double",
"type": "number"
},
"raw": {
"description": "Raw transfer amount (unadjusted).",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"from": {
"properties": {
"address": {
"description": "Wallet address.",
"type": "string"
},
"labels": {
"description": "Optional tags or labels describing the wallet.",
"nullable": true,
"type": "string"
},
"name": {
"description": "Optional human-readable label for the wallet.",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"to": {
"properties": {
"address": {
"description": "Wallet address.",
"type": "string"
},
"labels": {
"description": "Optional tags or labels describing the wallet.",
"nullable": true,
"type": "string"
},
"name": {
"description": "Optional human-readable label for the wallet.",
"nullable": true,
"type": "string"
}
},
"type": "object"
},
"token": {
"properties": {
"address": {
"description": "Token contract address.",
"type": "string"
},
"name": {
"description": "Full token name.",
"type": "string"
},
"symbol": {
"description": "Token symbol.",
"type": "string"
}
},
"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
}