Skip to main content
GET
/
v1
/
wallets
/
{walletAddressOrPublicKey}
/
history
Get wallet transaction history across multiple chains.
curl --request GET \
  --url https://api.moralis.com/v1/wallets/{walletAddressOrPublicKey}/history \
  --header 'X-Api-Key: <api-key>'
{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "addressType": "evm",
  "cursor": "<string>",
  "page": 1,
  "pageSize": 123,
  "result": [
    {
      "chainId": "0x1",
      "block": {
        "number": 123,
        "timestamp": "<string>",
        "hash": "<string>"
      },
      "transaction": {
        "hash": "<string>",
        "index": 123,
        "status": "<string>",
        "category": "<string>",
        "summary": "<string>",
        "methodLabel": "<string>",
        "possibleSpam": true,
        "initiatedBy": {
          "address": "<string>",
          "addressLabel": "<string>",
          "entity": {
            "id": "<string>",
            "name": "<string>",
            "logo": "<string>"
          }
        },
        "from": {
          "address": "<string>",
          "addressLabel": "<string>",
          "entity": {
            "id": "<string>",
            "name": "<string>",
            "logo": "<string>"
          }
        },
        "to": {
          "address": "<string>",
          "addressLabel": "<string>",
          "entity": {
            "id": "<string>",
            "name": "<string>",
            "logo": "<string>"
          }
        },
        "fee": {
          "amount": "<string>",
          "amountRaw": "<string>"
        },
        "confirmations": 123,
        "nativeTransfers": {
          "items": [
            {
              "fromAddress": "<string>",
              "toAddress": "<string>",
              "amount": "<string>",
              "isInternal": true
            }
          ],
          "hasMore": true
        },
        "tokenTransfers": {
          "items": [
            {
              "fromAddress": "<string>",
              "toAddress": "<string>",
              "value": "<string>",
              "tokenAddress": "<string>",
              "tokenSymbol": "<string>",
              "tokenName": "<string>",
              "tokenDecimals": 123,
              "tokenLogo": "<string>"
            }
          ],
          "hasMore": true
        },
        "nftTransfers": {
          "items": [
            {
              "fromAddress": "<string>",
              "toAddress": "<string>",
              "tokenAddress": "<string>",
              "tokenId": "<string>",
              "amount": "<string>",
              "tokenType": "<string>"
            }
          ],
          "hasMore": true
        }
      },
      "raw": {
        "evm": {
          "nonce": "<string>",
          "transactionType": "<string>",
          "gas": {
            "gasLimit": "<string>",
            "gasUsed": "<string>",
            "gasPrice": "<string>",
            "effectiveGasPrice": "<string>",
            "maxFeePerGas": "<string>",
            "maxPriorityFeePerGas": "<string>",
            "cumulativeGasUsed": "<string>"
          },
          "methodId": "<string>",
          "contractAddress": "<string>",
          "receiptStatus": "<string>",
          "input": "<string>",
          "decodedInput": {},
          "logs": {
            "items": [
              {
                "address": "<string>",
                "blockHash": "<string>",
                "data": "<string>",
                "logIndex": 123,
                "topic0": "<string>",
                "topic1": "<string>",
                "topic2": "<string>",
                "topic3": "<string>",
                "transactionHash": "<string>"
              }
            ],
            "hasMore": true
          },
          "internalTransactions": {
            "items": [
              {}
            ],
            "hasMore": true
          }
        }
      },
      "meta": {}
    }
  ],
  "meta": {
    "syncedAt": {
      "0x1": -1
    },
    "unsupportedChains": [
      "<string>"
    ],
    "failedChains": [
      "<string>"
    ],
    "missingTransactions": null
  }
}

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.

For Bitcoin history, pass chains=bitcoin as a query parameter. The walletAddressOrPublicKey path parameter accepts either a Bitcoin address or an xpub — when an xpub is supplied, history is aggregated across all derived addresses server-side.

Authorizations

X-Api-Key
string
header
required

Path Parameters

walletAddressOrPublicKey
string
required

The address or public key of the account

Query Parameters

chains
enum<string>[]

Chains to query

Available options:
0x1,
ethereum,
0x171,
pulse,
0x2105,
base,
0x38,
binance,
0x530,
sei-testnet,
0x531,
sei,
0x89,
polygon,
0x8f,
monad,
0xa,
optimism,
0xa86a,
avalanche,
solana-mainnet,
sol,
all,
mainnets,
testnets
limit
number
default:100

The limit per page

Required range: 1 <= x <= 100
cursor
string

The cursor to the next page

order
enum<string>
default:DESC

The order of items

Available options:
ASC,
DESC
fromDate
string

The start date from which to get the wallet history (format in seconds or string accepted by momentjs)

  • Provide the param 'fromBlock' or 'fromDate'
  • If 'fromDate' and 'fromBlock' are provided, 'fromBlock' will be used.
toDate
string

The end date from which to get the wallet history (format in seconds or string accepted by momentjs)

  • Provide the param 'toBlock' or 'toDate'
  • If 'toDate' and 'toBlock' are provided, 'toBlock' will be used.
fromBlock
number

The minimum block number from which to get the wallet history

  • Provide the param 'fromBlock' or 'fromDate'
  • If 'fromDate' and 'fromBlock' are provided, 'fromBlock' will be used.
toBlock
number

The block number to get the wallet history until

verbose
boolean
default:false

When true, returns full raw chain-specific data including logs, input data, and vin/vout arrays. Array fields are capped at 100 items with a hasMore flag.

Response

200 - application/json
address
string
required

The queried wallet address

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

addressType
enum<string>
required

Address type derived from chain family (evm for Ethereum-compatible, bitcoin for BTC, solana for Solana)

Available options:
evm,
bitcoin,
solana
Example:

"evm"

cursor
string | null
required

Opaque cursor token for pagination (null when no more pages)

page
number
required

Current page number (1-indexed)

Example:

1

pageSize
number
required

Number of items in this page

result
object[]
required

Array of wallet history items

meta
object
required

Response metadata with sync status and diagnostics