Get 25 token transfers (per page) for a specific token based on the sort order.
Default is most recent transfers first.
**NOTE:** This tool does not support native tokens (so11111111111111111111111111111111111111112, 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee).
Columns returned:
- **Time**: Timestamp when the transfer occurred (block_timestamp: ISO 8601 format)
- **From Label**: Source address label (from_address_label: sender of tokens)
- **To Label**: Destination address label (to_address_label: receiver of tokens)
- **From Address**: Raw source address (from_address: hex address)
- **To Address**: Raw destination address (to_address: hex address)
- **Amount**: Quantity of tokens transferred (transfer_amount: numeric)
- **Value USD**: USD value of the transfer at time of transaction (transfer_value_usd: currency formatted)
- **Type**: Transfer category (transaction_type: DEX, CEX, transfer, etc.)
- **Tx Hash**: Blockchain transaction hash for verification (transaction_hash)
Sorting Options (all fields support "asc"/"desc"):
Available for sorting: timestamp, amount
Examples:
# Basic request (most recent transfers first)
```
{
"chain": "ethereum",
"tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
"dateRange": {"from": "24H_AGO", "to": "NOW"},
"order_by": "timestamp",
"order_by_direction": "desc"
}
```
# Smart money only filter (largest transfers first)
```
{
"chain": "ethereum",
"tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
"dateRange": {"from": "7D_AGO", "to": "NOW"},
"transferOriginCategories": ["all_transfers"],
"onlySmartTradersAndFunds": true,
"order_by": "amount",
"order_by_direction": "desc"
}
```
# Filter by DEX only with minimum transfer value (USD)
```
{
"chain": "ethereum",
"tokenAddress": "0xa0b86a33e6b6c4b3add000b44b3a1234567890ab",
"dateRange": {"from": "24H_AGO", "to": "NOW"},
"transferOriginCategories": ["dex"],
"transferValueUsd": {"from": 1000}
}
```
# Filter transfers sent FROM a specific wallet
```
{
"chain": "base",
"tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
"dateRange": {"from": "2025-03-12", "to": "2025-03-12"},
"fromAddress": "0x2b060b9c89B8aD04e5E1fD40F1f327e41DD32c72",
"order_by": "timestamp",
"order_by_direction": "desc"
}
```
**Available Filters:**
Address Filters:
- **fromAddress** (str or list[str], optional): Filter by sender address(es)
Example: "0x2b060b9c89B8aD04e5E1fD40F1f327e41DD32c72"
Example: ["0xaddr1", "0xaddr2"]
- **toAddress** (str or list[str], optional): Filter by recipient address(es)
Use fromAddress/toAddress when looking for a specific wallet's transfers.
Transfer Origin Categories:
- **transferOriginCategories** (list[str]): List of transfer types to include
Possible values: ['dex', 'cex', 'non_exchange_transfers', 'all_transfers']
Default: ['all_transfers']
Examples:
- ['dex'] - only DEX transfers
- ['cex'] - only CEX transfers
- ['dex', 'cex'] - both DEX and CEX
- ['non_exchange_transfers'] - only non-exchange transfers
- ['all_transfers'] - all types (default)
Smart Money Filter:
- **onlySmartTradersAndFunds** (bool): Only show smart money transfers (default: false)
When true, filters to show **only** transfers involving profitable addresses
Numeric Range Filter:
- **transferValueUsd** (object, optional): Filter by USD value of transfer
Format: {"from": X, "to": Y} or {"from": X} or {"to": Y}
- Specify only `from` for minimum bound (no maximum)
- Specify only `to` for maximum bound (no minimum)
- Specify both for a bounded range
Example: {"from": 1000} - only transfers worth at least $1,000 USD
Example: {"to": 50000} - only transfers up to $50,000 USD
Example: {"from": 1000, "to": 50000} - transfers between $1,000 and $50,000 USD
Note: This filters by the USD value of the transfer at time of transaction
Notes:
- Use fromAddress/toAddress to find transfers for a specific wallet
- Use transferOriginCategories to control which transfer origins are included
- Smart Money filter shows **only** transfers involving profitable addresses (definition of *Smart Money*)
- transferValueUsd filters by USD value at time of transaction
