get_transactions_by_address
Retrieve native currency transfers and smart contract interactions for a specific address, excluding token transfers. Use date ranges or method filters to refine results. Supports pagination for large datasets.
Instructions
Retrieves native currency transfers and smart contract interactions (calls, internal txs) for an address.
**EXCLUDES TOKEN TRANSFERS**: Filters out direct token balance changes (ERC-20, etc.). You'll see calls *to* token contracts, but not the `Transfer` events. For token history, use `get_token_transfers_by_address`.
A single tx can have multiple records from internal calls; use `internal_transaction_index` for execution order.
Use cases:
- `get_transactions_by_address(address, age_from)` - get all txs to/from the address since a given date.
- `get_transactions_by_address(address, age_from, age_to)` - get all txs to/from the address between given dates.
- `get_transactions_by_address(address, age_from, age_to, methods)` - get all txs to/from the address between given dates, filtered by method.
**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 sender or receiver of the transaction | |
age_from | No | Start date and time (e.g 2025-05-22T23:00:00.00Z). | |
age_to | No | End date and time (e.g 2025-05-22T22:30:00.00Z). | |
chain_id | Yes | The ID of the blockchain | |
cursor | No | The pagination cursor from a previous response to get the next page of results. | |
methods | No | A method signature to filter transactions by (e.g 0x304e6ade) |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "Address which either sender or receiver of the transaction",
"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).",
"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).",
"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"
},
"methods": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "A method signature to filter transactions by (e.g 0x304e6ade)",
"title": "Methods"
}
},
"required": [
"chain_id",
"address"
],
"title": "get_transactions_by_addressArguments",
"type": "object"
}