Get Transaction History
octav_get_transactionsQuery and filter wallet transaction history by chain, type, protocol, counterparty, date, NFT token ID, and spam/dust; paginate up to 250 results per request.
Instructions
Query transaction history with filtering and pagination. Filter by chain, type, protocol, counterparty, text search, NFT token ID, and date range, and hide spam or dust. Max 250 transactions per request. Costs 1 credit per address.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"addresses": "<addresses>"
},
"name": "octav_get_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort by timestamp (default: NEWEST) | |
| type | No | Filter by transaction types, comma-separated (e.g., SWAP,DEPOSIT) | |
| chain | No | Filter by chain keys, comma-separated (e.g., ethereum,arbitrum,base). See octav_get_chains. | |
| limit | No | Number of transactions to return (default: 50, max: 250) | |
| offset | No | Pagination offset (default: 0) | |
| search | No | Full-text search over token symbols, names and addresses | |
| endDate | No | End date for filtering (YYYY-MM-DD) | |
| tokenId | No | Filter by NFT token ID | |
| hideDust | No | Exclude dust transactions | |
| hideSpam | No | Exclude spam transactions | |
| protocol | No | Filter by protocol keys, comma-separated. See octav_get_chain_protocols. | |
| addresses | Yes | Array with one wallet address (EVM: 0x... or Solana base58). The API accepts one address per call. | |
| startDate | No | Start date for filtering (YYYY-MM-DD) | |
| interactingAddresses | No | Only transactions with these counterparty addresses |