get_token_transfers_by_address
Retrieve ERC-20 token transfers for a specific address within a defined time range. Filter by token or paginate results for large datasets to analyze blockchain transaction history efficiently.
Instructions
Get ERC-20 token transfers for an address within a specific time range.
Use cases:
- `get_token_transfers_by_address(address, age_from)` - get all transfers of any ERC-20 token to/from the address since the given date up to the current time
- `get_token_transfers_by_address(address, age_from, age_to)` - get all transfers of any ERC-20 token to/from the address between the given dates
- `get_token_transfers_by_address(address, age_from, age_to, token)` - get all transfers of the given ERC-20 token to/from the address between the given dates
**SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
address | Yes | Address which either transfer initiator or transfer receiver | |
age_from | No | Start date and time (e.g 2025-05-22T23:00:00.00Z). This parameter should be provided in most cases to limit transfers and avoid heavy database queries. Omit only if you absolutely need the full history. | |
age_to | No | End date and time (e.g 2025-05-22T22:30:00.00Z). Can be omitted to get all transfers up to the current time. | |
chain_id | Yes | The ID of the blockchain | |
cursor | No | The pagination cursor from a previous response to get the next page of results. | |
token | No | An ERC-20 token contract address to filter transfers by a specific token. If omitted, returns transfers of all tokens. |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "Address which either transfer initiator or transfer receiver",
"title": "Address",
"type": "string"
},
"age_from": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Start date and time (e.g 2025-05-22T23:00:00.00Z). This parameter should be provided in most cases to limit transfers and avoid heavy database queries. Omit only if you absolutely need the full history.",
"title": "Age From"
},
"age_to": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "End date and time (e.g 2025-05-22T22:30:00.00Z). Can be omitted to get all transfers up to the current time.",
"title": "Age To"
},
"chain_id": {
"description": "The ID of the blockchain",
"title": "Chain Id",
"type": "string"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The pagination cursor from a previous response to get the next page of results.",
"title": "Cursor"
},
"token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "An ERC-20 token contract address to filter transfers by a specific token. If omitted, returns transfers of all tokens.",
"title": "Token"
}
},
"required": [
"chain_id",
"address"
],
"title": "get_token_transfers_by_addressArguments",
"type": "object"
}