Get History of account
getHistoryOfAccountRetrieve the transaction history for any VeChain address or VNS name. Filter by activity type, such as transfers, staking, swaps, NFT trades, or governance votes, to analyze account interactions.
Instructions
Retrieve transaction history for a VeChain address with filtering support.
IMPORTANT: Pass ARRAYS of event names to fetch multiple event types in ONE call - this is much more efficient than separate calls.
Available Event Types:
STARGATE STAKING (Current - Post-Hayabusa):
STARGATE_STAKE: User stakes VET and mints Stargate NFT
STARGATE_UNSTAKE: User unstakes VET and burns NFT
STARGATE_DELEGATE_REQUEST: User requests to delegate NFT to validator
STARGATE_DELEGATE_ACTIVE: Delegation becomes active with validator
STARGATE_DELEGATE_EXIT_REQUEST: User requests to exit delegation
STARGATE_DELEGATION_EXITED: Delegation fully exited, can unstake
STARGATE_DELEGATION_EXITED_VALIDATOR: Validator-side exit event
STARGATE_DELEGATE_REQUEST_CANCELLED: Delegation request cancelled before activation
STARGATE_CLAIM_REWARDS: User claims VTHO staking rewards
STARGATE_BOOST: User boosts NFT maturity with VTHO payment
STARGATE_MANAGER_ADDED: User adds manager address to control NFT
STARGATE_MANAGER_REMOVED: Manager address removed from NFT
STARGATE LEGACY (Pre-Hayabusa - Historical only):
STARGATE_DELEGATE_LEGACY: Old delegation system
STARGATE_CLAIM_REWARDS_BASE_LEGACY: Old base rewards
STARGATE_CLAIM_REWARDS_DELEGATE_LEGACY: Old delegation rewards
STARGATE_UNDELEGATE_LEGACY: Old undelegation
TRANSFERS:
TRANSFER_VET: Native VET token transfers
TRANSFER_FT: Fungible token (VIP-180) transfers - includes VTHO, other tokens
TRANSFER_NFT: NFT (VIP-181/VIP-721) transfers
TRANSFER_SF: Semi-fungible token transfers
SWAPS (DEX Activity):
SWAP_VET_TO_FT: Swapping VET for tokens
SWAP_FT_TO_VET: Swapping tokens for VET
SWAP_FT_TO_FT: Token-to-token swaps
VEBETTERDAO (B3TR Ecosystem):
B3TR_SWAP_VOT3_TO_B3TR: Converting VOT3 governance token to B3TR
B3TR_SWAP_B3TR_TO_VOT3: Converting B3TR to VOT3
B3TR_PROPOSAL_SUPPORT: Supporting a proposal with B3TR
B3TR_PROPOSAL_VOTE: Voting on governance proposal
B3TR_PROPOSAL_WITHDRAW: Withdrawing a B3TR proposal
B3TR_XALLOCATION_VOTE: Voting on X-Allocation distribution
B3TR_CLAIM_REWARD: Claiming B3TR ecosystem rewards
B3TR_UPGRADE_GM: Upgrading governance model
B3TR_ACTION: General B3TR ecosystem action
GOVERNANCE:
VEVOTE_VOTE_CAST: Vote cast in VeVote governance system
OTHER:
NFT_SALE: NFT marketplace sale transaction
UNKNOWN_TX: Unclassified transaction type
Common Query Patterns:
Complete Stargate history: ["STARGATE_STAKE", "STARGATE_UNSTAKE", "STARGATE_DELEGATE_REQUEST", "STARGATE_DELEGATE_ACTIVE", "STARGATE_DELEGATE_EXIT_REQUEST", "STARGATE_DELEGATION_EXITED", "STARGATE_CLAIM_REWARDS", "STARGATE_BOOST", "STARGATE_MANAGER_ADDED", "STARGATE_MANAGER_REMOVED"]
All asset transfers: ["TRANSFER_VET", "TRANSFER_FT", "TRANSFER_NFT", "TRANSFER_SF"]
Trading activity: ["SWAP_VET_TO_FT", "SWAP_FT_TO_VET", "SWAP_FT_TO_FT"]
Filters:
eventName: Single string OR array (ALWAYS prefer arrays for related events)
searchBy: 'to' | 'from' | 'origin' | 'gasPayer' - filter by address role
contractAddress: Filter by specific contract interactions
after/before: Unix timestamps in SECONDS (NOT milliseconds). Example: 2025-08-03 00:00 UTC = 1754179200, 2025-08-04 00:00 UTC = 1754265600
Pagination: page, size, cursor, direction (ASC/DESC)
Returns paginated array of events with full transaction details.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Zero-based results page number (0 is the first page) | |
| size | No | Results per page (1..150); API default is typically 20 | |
| after | No | Optional filter by after timestamp (Unix seconds, e.g. 1754179200 for 2025-08-03T00:00:00Z). Use seconds, NOT milliseconds. | |
| before | No | Optional filter by before timestamp (Unix seconds, e.g. 1754265600 for 2025-08-04T00:00:00Z). Use seconds, NOT milliseconds. | |
| cursor | No | Opaque cursor for fetching the next page when provided by the API | |
| address | Yes | The account address or VNS (.vet) name to retrieve | |
| searchBy | No | Optional filter by search by (to, from, origin, gasPayer) | |
| direction | No | Sort direction for time-based queries; defaults to 'DESC' (newest first) | |
| eventName | No | Optional filter by event name(s). Can be a single event or an array of events | |
| contractAddress | No | Optional filter by contract address |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| error | No | ||
| network | Yes |