> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moralis.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Wallet History
> Get the complete decoded transaction history for a given wallet. All transactions are parsed, decoded, categorized and summarized into human-readable records.
export const EndpointMeta = ({premium, cus, cusUnit, mainnetOnly}) => {
const items = [];
const planName = typeof premium === "string" ? premium : "Pro";
if (premium) {
items.push({
icon: "\u26a0\ufe0f",
label: "Premium endpoint",
text: <>
Requires the {planName} plan or above.{" "}
View all
.
});
}
if (cus) {
const isDynamic = !!cusUnit;
items.push({
icon: "\u26a1",
label: isDynamic ? "Dynamic cost" : "Endpoint cost",
text: isDynamic ? <>
{cus} CUs per {cusUnit}.{" "}
Learn more.
: <>
{cus} CUs.{" "}
Learn more.
});
}
if (mainnetOnly) {
items.push({
icon: "\ud83d\udd17",
label: "Mainnet only",
text: <>Testnet chains are not supported.
});
}
if (items.length === 0) return null;
return
{items.map((item, i) =>
{item.icon}
{item.label}:
{" "}
{item.text}
)}
;
};
## OpenAPI
````yaml /openapi-files/data-api/api.json GET /wallets/{address}/history
openapi: 3.0.0
info:
title: EVM API
version: '2.2'
servers:
- url: https://deep-index.moralis.io/api/v2.2
security:
- ApiKeyAuth: []
tags: []
paths:
/wallets/{address}/history:
get:
tags:
- Wallets
summary: Get the complete decoded transaction history of a wallet
description: >-
Get the complete decoded transaction history for a given wallet. All
transactions are parsed, decoded, categorized and summarized into
human-readable records.
operationId: getWalletHistory
parameters:
- in: query
name: chain
description: The chain to query
required: false
schema:
$ref: '#/components/schemas/chainList'
- in: query
name: from_block
description: >
The minimum block number from which to get the transactions
* Provide the param 'from_block' or 'from_date'
* If 'from_date' and 'from_block' are provided, 'from_block' will be
used.
required: false
schema:
type: integer
minimum: 0
- in: query
name: to_block
description: |
The maximum block number from which to get the transactions.
* Provide the param 'to_block' or 'to_date'
* If 'to_date' and 'to_block' are provided, 'to_block' will be used.
required: false
schema:
type: integer
minimum: 0
- in: query
name: from_date
description: >
The start date from which to get the transactions (format in seconds
or datestring accepted by momentjs)
* Provide the param 'from_block' or 'from_date'
* If 'from_date' and 'from_block' are provided, 'from_block' will be
used.
required: false
schema:
type: string
- in: query
name: to_date
description: >
Get the transactions up to this date (format in seconds or
datestring accepted by momentjs)
* Provide the param 'to_block' or 'to_date'
* If 'to_date' and 'to_block' are provided, 'to_block' will be used.
schema:
type: string
- in: path
name: address
description: The address of the wallet
required: true
schema:
type: string
example: '0xcB1C1FdE09f811B294172696404e88E658659905'
- in: query
name: include_internal_transactions
description: If the result should contain the internal transactions.
required: false
schema:
type: boolean
- in: query
name: nft_metadata
description: If the result should contain the nft metadata.
required: false
schema:
type: boolean
- in: query
name: cursor
description: >-
The cursor returned in the previous response (used for getting the
next page).
schema:
type: string
- in: query
name: order
description: The order of the result, in ascending (ASC) or descending (DESC)
required: false
schema:
$ref: '#/components/schemas/orderList'
- in: query
name: limit
description: The desired page size of the result.
required: false
schema:
type: integer
minimum: 0
responses:
'200':
description: Returns wallet history of a wallet address
content:
application/json:
schema:
$ref: '#/components/schemas/walletHistory'
security:
- ApiKeyAuth: []
components:
schemas:
chainList:
type: string
example: eth
default: eth
enum:
- eth
- '0x1'
- sepolia
- '0xaa36a7'
- polygon
- '0x89'
- bsc
- '0x38'
- bsc testnet
- '0x61'
- avalanche
- '0xa86a'
- cronos
- '0x19'
- arbitrum
- '0xa4b1'
- chiliz
- '0x15b38'
- gnosis
- '0x64'
- base
- '0x2105'
- base sepolia
- '0x14a34'
- optimism
- '0xa'
- polygon amoy
- '0x13882'
- linea
- '0xe708'
- moonbeam
- '0x504'
- moonriver
- '0x505'
- flow
- '0x2eb'
- flow-testnet
- '0x221'
- ronin
- '0x7e4'
- ronin-testnet
- '0x31769'
- lisk
- '0x46f'
- pulse
- '0x171'
- sei-testnet
- '0x530'
- sei
- '0x531'
- monad
- '0x8f'
orderList:
type: string
example: DESC
default: DESC
enum:
- ASC
- DESC
walletHistory:
required:
- result
- page
- page_size
- cursor
properties:
page:
type: integer
description: The current page of the result
example: '2'
page_size:
type: integer
description: The number of results per page
example: '100'
cursor:
type: string
description: The cursor to get to the next page
result:
type: array
items:
$ref: '#/components/schemas/walletHistoryTransaction'
walletHistoryTransaction:
type: object
required:
- hash
- nonce
- transaction_index
- from_address
- value
- gas_price
- receipt_cumulative_gas_used
- receipt_gas_used
- receipt_status
- block_timestamp
- block_number
- block_hash
- category
- nft_transfers
- summary
- erc20_transfers
- native_transfers
- contract_interactions
properties:
hash:
type: string
description: The hash of the transaction
example: '0x1ed85b3757a6d31d01a4d6677fc52fd3911d649a0af21fe5ca3f886b153773ed'
nonce:
type: string
description: The nonce
example: '1848059'
transaction_index:
type: string
example: '108'
from_address_entity:
type: string
description: The from address entity
example: Opensea
from_address_entity_logo:
type: string
description: The logo of the from address entity
example: https://opensea.io/favicon.ico
from_address:
type: string
description: The from address
example: '0x267be1c1d684f78cb4f6a176c4911b741e4ffdc0'
from_address_label:
type: string
nullable: true
description: The label of the from address
example: Binance 1
to_address_entity:
type: string
description: The to address entity
example: Beaver Build
to_address_entity_logo:
type: string
description: The logo of the to address entity
example: https://beaverbuild.com/favicon.ico
to_address:
type: string
nullable: true
description: The to address
example: '0x003dde3494f30d861d063232c6a8c04394b686ff'
to_address_label:
type: string
nullable: true
description: The label of the to address
example: Binance 2
value:
type: string
description: The value sent
example: '115580000000000000'
gas:
type: string
example: '30000'
gas_price:
type: string
description: The gas price
example: '52500000000'
input:
type: string
example: 0x
receipt_cumulative_gas_used:
type: string
example: '4923073'
receipt_gas_used:
type: string
example: '21000'
receipt_contract_address:
type: string
example: '0x9869524fd160fe3adda6218883b6526c0977d3a5'
nullable: true
receipt_status:
type: string
example: '1'
transaction_fee:
type: string
example: '0.00000000000000063'
block_timestamp:
type: string
description: The block timestamp
example: '2021-05-07T11:08:35.000Z'
block_number:
type: string
description: The block number
example: '12386788'
block_hash:
type: string
description: The hash of the block
example: '0x9b559aef7ea858608c2e554246fe4a24287e7aeeb976848df2b9a2531f4b9171'
internal_transactions:
type: array
description: The internal transactions of the transaction
items:
$ref: '#/components/schemas/internalTransaction'
category:
$ref: '#/components/schemas/ETransactionCategory'
contract_interactions:
$ref: '#/components/schemas/ResolveContractInteractionResponse'
type: array
description: The contract interactions that happend in the transaction
possible_spam:
type: boolean
description: Is transaction possible spam
example: 'false'
method_label:
type: string
description: The label of the method called if any called
example: transfer
summary:
type: string
description: Summary of what happened on the transaction
example: transfer
nft_transfers:
type: array
items:
$ref: '#/components/schemas/walletHistoryNftTransfer'
erc20_transfers:
type: array
items:
$ref: '#/components/schemas/walletHistoryErc20Transfer'
native_transfers:
type: array
items:
$ref: '#/components/schemas/native_transfer'
logs:
type: array
items:
$ref: '#/components/schemas/logVerbose'
internalTransaction:
type: object
required:
- transaction_hash
- block_number
- block_hash
- type
- from
- to
- value
- gas
- gas_used
- input
- output
- error
properties:
transaction_hash:
type: string
description: The hash of the transaction
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
block_number:
type: string
description: The block number
example: 12526958
block_hash:
type: string
description: The block hash
example: '0x0372c302e3c52e8f2e15d155e2c545e6d802e479236564af052759253b20fd86'
type:
type: string
description: Call type
example: CALL
from:
type: string
description: The sender
example: '0xd4a3BebD824189481FC45363602b83C9c7e9cbDf'
to:
type: string
description: The recipient
example: '0xa71db868318f0a0bae9411347cd4a6fa23d8d4ef'
value:
type: string
description: The value that was transfered (in wei)
example: '650000000000000000'
gas:
type: string
description: The gas of the transaction
example: '6721975'
gas_used:
type: string
description: The used gas
example: '6721975'
input:
type: string
description: The input
example: 0x
output:
type: string
description: The output
example: 0x
error:
type: string
nullable: true
description: Error message if the internal transaction failed
example: Execution reverted
ETransactionCategory:
type: string
enum:
- send
- receive
- token send
- token receive
- nft send
- nft receive
- token swap
- deposit
- withdraw
- nft purchase
- nft sale
- airdrop
- mint
- burn
- borrow
- contract interaction
description: Defines the category of the transaction.
ResolveContractInteractionResponse:
oneOf:
- $ref: '#/components/schemas/ApprovalResponse'
- $ref: '#/components/schemas/RevokeResponse'
- $ref: '#/components/schemas/SetApprovalAllResponse'
- $ref: '#/components/schemas/SetRevokeAllResponse'
walletHistoryNftTransfer:
required:
- token_address
- token_id
- log_index
- contract_type
- possible_spam
- value
- amount
- transaction_type
- direction
- from_address
- verified
properties:
token_address:
type: string
description: The address of the NFT contract
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
token_id:
type: string
description: The token ID of the NFT
example: '15'
token_name:
type: string
example: Tether USD
token_symbol:
type: string
example: USDT
from_address_entity:
type: string
description: The from address entity
example: Opensea
from_address_entity_logo:
type: string
description: The logo of the from address entity
example: https://opensea.io/favicon.ico
from_address:
type: string
description: The address that sent the NFT
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
from_address_label:
type: string
nullable: true
description: The label of the from address
example: Binance 1
to_address_entity:
type: string
description: The to address entity
example: Beaver Build
to_address_entity_logo:
type: string
description: The logo of the to address entity
example: https://beaverbuild.com/favicon.ico
to_address:
type: string
description: The address that received the NFT
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
to_address_label:
type: string
nullable: true
description: The label of the to address
example: Binance 2
value:
type: string
description: The value that was sent in the transaction (ETH/BNB/etc..)
example: '1000000000000000'
amount:
type: string
description: The number of tokens transferred
example: '1'
contract_type:
type: string
description: The type of NFT contract standard
example: ERC721
transaction_type:
type: string
description: The transaction type
log_index:
type: integer
description: The log index
operator:
type: string
description: The operator present only for ERC1155 transfers
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
possible_spam:
type: boolean
description: Indicates if a contract is possibly a spam contract
example: 'false'
verified_collection:
type: boolean
description: Indicates if a contract is verified
example: 'false'
direction:
type: string
description: The direction of the transfer
example: outgoing
collection_logo:
type: string
description: The logo of the collection
example: >-
https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png
collection_banner_image:
type: string
description: The banner image of the collection
example: >-
https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png
normalized_metadata:
$ref: '#/components/schemas/normalizedMetadata'
description: A normalized metadata version of the NFT's metadata.
walletHistoryErc20Transfer:
required:
- token_name
- token_symbol
- token_logo
- token_decimals
- value_formatted
- address
- from_address
- value
- transaction_index
- log_index
- possible_spam
- verified_contract
properties:
token_name:
type: string
example: Tether USD
token_symbol:
type: string
example: USDT
token_logo:
type: string
example: https://cdn.moralis.io/images/325/large/Tether-logo.png?1598003707
token_decimals:
type: string
example: '6'
address:
type: string
description: The address of the token
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
block_timestamp:
type: string
description: The block timestamp
example: '2021-04-02T10:07:54.000Z'
to_address_entity:
type: string
description: The to address entity
example: Beaver Build
to_address_entity_logo:
type: string
description: The logo of the to address entity
example: https://beaverbuild.com/favicon.ico
to_address:
type: string
description: The recipient
example: '0x62AED87d21Ad0F3cdE4D147Fdcc9245401Af0044'
to_address_label:
type: string
nullable: true
description: The label of the to address
example: Binance 2
from_address_entity:
type: string
description: The from address entity
example: Opensea
from_address_entity_logo:
type: string
description: The logo of the from address entity
example: https://opensea.io/favicon.ico
from_address:
type: string
description: The sender
example: '0xd4a3BebD824189481FC45363602b83C9c7e9cbDf'
from_address_label:
type: string
nullable: true
description: The label of the from address
example: Binance 1
value:
type: string
description: The value that was transfered (in wei)
example: 650000000000000000
value_formatted:
type: string
description: The value that was transfered decimal format
example: '1.033'
log_index:
type: integer
description: The log index of the transfer within the block
example: 2
possible_spam:
type: boolean
description: Indicates if a contract is possibly a spam contract
example: 'false'
verified_contract:
type: boolean
description: Indicates if a contract is verified
example: 'false'
native_transfer:
required:
- from_address
- value
- value_formatted
- internal_transaction
- token_symbol
- token_logo
properties:
from_address_entity:
type: string
description: The from address entity
example: Opensea
from_address_entity_logo:
type: string
description: The logo of the from address entity
example: https://opensea.io/favicon.ico
from_address:
type: string
description: The address that sent the NFT
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
from_address_label:
type: string
nullable: true
description: The label of the from address
example: Binance 1
to_address_entity:
type: string
description: The to address entity
example: Beaver Build
to_address_entity_logo:
type: string
description: The logo of the to address entity
example: https://beaverbuild.com/favicon.ico
to_address:
type: string
description: The address that received the NFT
example: '0x057Ec652A4F150f7FF94f089A38008f49a0DF88e'
to_address_label:
type: string
nullable: true
description: The label of the to address
example: Binance 2
value:
type: string
description: The value that was sent in the transaction (ETH/BNB/etc..)
example: '1000000000000000'
value_formatted:
type: string
description: >-
The value that was sent in the transaction (ETH/BNB/etc..) in
decimal format
example: '0.1'
direction:
type: string
description: The direction of the transfer
example: outgoing
internal_transaction:
type: boolean
description: Indicates if the transaction is internal
example: 'false'
token_symbol:
type: string
description: The symbol of the token transferred
example: ETH
token_logo:
type: string
description: The logo of the token transferred
example: >-
https://cdn.moralis.io/eth/0x67b6d479c7bb412c54e03dca8e1bc6740ce6b99c.png
logVerbose:
required:
- log_index
- transaction_hash
- transaction_index
- address
- data
- topic0
- block_timestamp
- block_number
- block_hash
- decoded_event
properties:
log_index:
type: string
example: '273'
transaction_hash:
type: string
description: The hash of the transaction
example: '0xdd9006489e46670e0e85d1fb88823099e7f596b08aeaac023e9da0851f26fdd5'
transaction_index:
type: string
example: '204'
address:
type: string
description: The address of the contract
example: '0x3105d328c66d8d55092358cf595d54608178e9b5'
data:
type: string
description: The data of the log
example: >-
0x00000000000000000000000000000000000000000000000de05239bccd4d537400000000000000000000000000024dbc80a9f80e3d5fc0a0ee30e2693781a443
topic0:
type: string
example: '0x2caecd17d02f56fa897705dcc740da2d237c373f70686f4e0d9bd3bf0400ea7a'
topic1:
type: string
example: '0x000000000000000000000000031002d15b0d0cd7c9129d6f644446368deae391'
topic2:
type: string
example: '0x000000000000000000000000d25943be09f968ba740e0782a34e710100defae9'
topic3:
type: string
example: null
block_timestamp:
type: string
description: The timestamp of the block
example: '2021-05-07T11:08:35.000Z'
block_number:
type: string
description: The block number
example: '12386788'
block_hash:
type: string
description: The hash of the block
example: '0x9b559aef7ea858608c2e554246fe4a24287e7aeeb976848df2b9a2531f4b9171'
decoded_event:
$ref: '#/components/schemas/decodedEvent'
type: object
description: The decoded data of the log
ApprovalResponse:
type: object
properties:
approvals:
type: array
items:
$ref: '#/components/schemas/ApprovalData'
RevokeResponse:
type: object
properties:
revokes:
type: array
items:
$ref: '#/components/schemas/ApprovalData'
SetApprovalAllResponse:
type: object
properties:
set_approvals_all:
type: array
items:
$ref: '#/components/schemas/SetApprovalAllData'
SetRevokeAllResponse:
type: object
properties:
set_revokes_all:
type: array
items:
$ref: '#/components/schemas/SetApprovalAllData'
normalizedMetadata:
properties:
name:
type: string
description: The name or title of the NFT
example: Moralis Mug
description:
type: string
description: A detailed description of the NFT
example: >-
Moralis Coffee nug 3D Asset that can be used in 3D worldspaces. This
NFT is presented as a flat PNG, a Unity3D Prefab and a standard fbx.
image:
type: string
description: The URL of the NFT's image
example: >-
https://arw2wxg84h6b.moralishost.com:2053/server/files/tNJatzsHirx4V2VAep6sc923OYGxvkpBeJttR7Ks/de504bbadadcbe30c86278342fcf2560_moralismug.png
external_link:
type: string
description: A link to additional information
example: https://giphy.com/gifs/loop-recursion-ting-aaODAv1iuQdgI
external_url:
type: string
description: A link to additional information
example: https://giphy.com/gifs/loop-recursion-ting-aaODAv1iuQdgI
animation_url:
type: string
description: An animated version of the NFT's image
example: https://giphy.com/gifs/food-design-donuts-o9ngTPVYW4qo8
attributes:
type: array
items:
$ref: '#/components/schemas/normalizedMetadataAttribute'
decodedEvent:
type: object
properties:
signature:
type: string
example: Transfer(address,address,uint256)
label:
type: string
example: Transfer
type:
type: string
example: event
params:
type: array
items:
type: object
properties:
name:
type: string
example: from
value:
type: string
example: '0x26C5011483Add49801eA8E3Ee354fE013895aCe5'
type:
type: string
example: address
ApprovalData:
type: object
properties:
value:
type: string
value_formatted:
type: string
nullable: true
token:
$ref: '#/components/schemas/TokenDetails'
spender:
$ref: '#/components/schemas/SpenderDetails'
SetApprovalAllData:
type: object
properties:
token:
$ref: '#/components/schemas/TokenDetails'
operator:
$ref: '#/components/schemas/SpenderDetails'
normalizedMetadataAttribute:
properties:
trait_type:
type: string
description: The trait title or descriptor
example: Eye Color
value:
type: object
description: The value of the attribute
example: hazel
display_type:
type: string
description: The type the attribute value should be displayed as
example: string
max_value:
type: number
description: For numeric values, the upper range
example: 100
trait_count:
type: number
description: The number of possible values for this trait
example: 7
order:
type: number
description: Order the trait should appear in the attribute list.
example: 1
TokenDetails:
type: object
properties:
address:
type: string
address_label:
type: string
nullable: true
token_name:
type: string
token_logo:
type: string
token_symbol:
type: string
SpenderDetails:
type: object
properties:
address:
type: string
address_label:
type: string
nullable: true
name:
type: string
nullable: true
symbol:
type: string
nullable: true
logo:
type: string
nullable: true
entity:
type: string
nullable: true
entity_logo:
type: string
nullable: true
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
x-default: test
````