Skip to main content
Version: 2.2

Get wallet history

Don't have an API key yet?

Start using this API for your project today.

Get your free API key
GEThttps://deep-index.moralis.io/api/v2.2/wallets/:address/history

Retrieve the full transaction history of a specified wallet address, including sends, receives, token and NFT transfers, and contract interactions.

PATH PARAMS
addressstringrequired
The address of the wallet
QUERY PARAMS
chainstring
The chain to query
from_blocknumber

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.
to_blocknumber

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.
from_datestring

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.
to_datestring

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.
internal_transactionsboolean
If the result should contain the internal transactions.
nft_metadataboolean
If the result should contain the nft metadata.
cursorstring
The cursor returned in the previous response (used for getting the next page).
orderstring
The order of the result, in ascending (ASC) or descending (DESC)
limitnumber
The desired page size of the result.
Responses
API KEY
import Moralis from 'moralis';

try {
await Moralis.start({
apiKey: "YOUR_API_KEY"
});

const response = await Moralis.EvmApi.wallets.getWalletHistory({
"chain": "0x1",
"order": "DESC",
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
});

console.log(response.raw);
} catch (e) {
console.error(e);
}
Response Example
{
"page": "2",
"page_size": "100",
"cursor": "",
"result": [
{
"hash": "0x1ed85b3757a6d31d01a4d6677fc52fd3911d649a0af21fe5ca3f886b153773ed",
"nonce": "1848059",
"transaction_index": "108",
"from_address": "0x267be1c1d684f78cb4f6a176c4911b741e4ffdc0",
"from_address_label": "Binance 1",
"to_address": "0x003dde3494f30d861d063232c6a8c04394b686ff",
"to_address_label": "Binance 2",
"value": "115580000000000000",
"gas": "30000",
"gas_price": "52500000000",
"input": "0x",
"receipt_cumulative_gas_used": "4923073",
"receipt_gas_used": "21000",
"receipt_contract_address": "",
"receipt_root": "",
"receipt_status": "1",
"block_timestamp": "2021-05-07T11:08:35.000Z",
"block_number": "12386788",
"block_hash": "0x9b559aef7ea858608c2e554246fe4a24287e7aeeb976848df2b9a2531f4b9171",
"logs": [
""
],
"internal_transactions": [
{
"transaction_hash": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"block_number": "12526958",
"block_hash": "0x0372c302e3c52e8f2e15d155e2c545e6d802e479236564af052759253b20fd86",
"type": "CALL",
"from": "0xd4a3BebD824189481FC45363602b83C9c7e9cbDf",
"to": "0xa71db868318f0a0bae9411347cd4a6fa23d8d4ef",
"value": "650000000000000000",
"gas": "6721975",
"gas_used": "6721975",
"input": "0x",
"output": "0x"
}
],
"nft_transfers": [
{
"token_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"token_id": "15",
"from_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"from_address_label": "Binance 1",
"to_address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"to_address_label": "Binance 2",
"value": "1000000000000000",
"amount": "1",
"contract_type": "ERC721",
"block_number": "88256",
"block_timestamp": "2021-06-04T16:00:15",
"block_hash": "string",
"transaction_hash": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"transaction_type": "string",
"transaction_index": "",
"log_index": "",
"operator": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"possible_spam": "",
"verified_collection": ""
}
],
"erc20_transfer": [
{
"token_name": "Tether USD",
"token_symbol": "USDT",
"token_logo": "https://assets.coingecko.com/coins/images/325/large/Tether-logo.png?1598003707",
"token_decimals": "6",
"transaction_hash": "0x2d30ca6f024dbc1307ac8a1a44ca27de6f797ec22ef20627a1307243b0ab7d09",
"address": "0x057Ec652A4F150f7FF94f089A38008f49a0DF88e",
"block_timestamp": "2021-04-02T10:07:54.000Z",
"block_number": "12526958",
"block_hash": "0x0372c302e3c52e8f2e15d155e2c545e6d802e479236564af052759253b20fd86",
"to_address": "0x62AED87d21Ad0F3cdE4D147Fdcc9245401Af0044",
"to_address_label": "Binance 2",
"from_address": "0xd4a3BebD824189481FC45363602b83C9c7e9cbDf",
"from_address_label": "Binance 1",
"value": "650000000000000000",
"transaction_index": 12,
"log_index": 2,
"possible_spam": "",
"verified_contract": ""
}
]
}
]
}