Get History of account
getHistoryOfAccountRetrieve transaction history for a VeChain address with filters for event types, time range, and address roles. Supports staking, transfers, swaps, governance, and more.
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 |