Skip to main content

Don't have an API key yet?

Sign-up to Moralis to get your free API key and start building today.

Get Your Free API Key
Version: 2.2

Wallet History FAQs

Endpoint Overview​

The Wallet History endpoint provides a single API call solution to fetch a comprehensive, chronological history of a wallet's activity. This endpoint consolidates all transaction types, including transfers, token swaps, NFT sales, token operations, and interactions with smart contracts, simplifying the data retrieval process for developers.

Features

  • Single API Request: Retrieve a full timeline of a wallet’s activities with one API call.
  • Automatic Categorization: Each transaction is automatically categorized into types such as Send, Receive, NFT Send/Receive, Token Send/Receive, Deposit, Withdraw, Token Swap, Airdrop, Mint, Burn, NFT Purchase, NFT Sale, Borrow, and Contract Interaction.
  • Reduced Complexity: Eliminates the need to aggregate data from multiple API calls, reducing complexity and potential data inconsistency.
  • Comprehensive Data: Provides detailed insights into all transactions, token transfers, and NFT activities associated with a wallet address.

Wallet History Categories​

We are continuously extending support for categories. We currently support:

  • Send
  • Receive
  • NFT Send
  • NFT Receive
  • Token Send
  • Token Receive
  • Deposit
  • Withdraw
  • Token Swap
  • Airdrop
  • Mint
  • Burn
  • NFT Purchase
  • NFT Sale
  • Borrow
  • Approve
  • Revoke
  • Contract Interaction

Approvals and Revokes​

Detailed approval or revoke information can be accessed within the contract_interactions object. Currently, the contract_interactions decodes setApprovalForAll (log event ApprovalForAll) and approve (log event Approval) transactions, while revoke categories are defined as approvals with a value of 0 or where setApprovalForAll is false.

Here's an example of an approve transaction:

"category": "approve",
"summary": "Approved 0.000123 USDT",
"contract_interactions": {
"approvals": [
{
"value": "1230000000000000",
"value_formatted": "0.000123",
"token": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"address_label": "Tether USD (USDT)",
"token_name": "Tether USD",
"token_logo": "https://cdn.moralis.io/eth/0xdac17f958d2ee523a2206206994597c13d831ec7.png",
"token_symbol": "USDT"
},
"spender": {
"address": "0x111111125421ca6dc452d289314280a0f8842a65",
"address_label": null
}
}
]
}
Log EventCategoryDecoded Payload
Approval > 0approvecontract_interactions.approvals:[]
ApprovalForAll = trueapprovecontract_interactions.set_approvals_all:[]
Approval = 0revokecontract_interactions.revokes:[]
ApprovalForAll = falserevokecontract_interactions.set_revokes_all:[]

What Query Parameters Are Supported?​

  • chain: Choose the blockchain to query
  • from_block and to_block: Set the block range for the transactions you're interested in. If both from_date and from_block (or to_date and to_block) are provided, the block parameter takes precedence.
  • from_date and to_date: Specify the date range for transactions. Accepts seconds or date strings compatible with moment.js.
  • include_internal_transactions: Include internal transactions in your results when set to true. By default, native_transfers always include internal transactions.
  • nft_metadata: Include NFT metadata in your results when set to true.
  • include_input_data: Includes the raw transaction input data when set to true. This also decodes the transaction to populate the method_label.
  • cursor: Use this to paginate through results, utilizing the cursor provided in the previous response.
  • order: Sort the results in ascending (ASC) or descending (DESC) order.
  • limit: Adjust the page size of your results to your preference.

Start building with the most powerful Wallet History endpoint today 🚀