Skip to main content
GET
/
wallets
/
{address}
/
insight
Get wallet insight metrics
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/wallets/{address}/insight \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://deep-index.moralis.io/api/v2.2/wallets/{address}/insight"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://deep-index.moralis.io/api/v2.2/wallets/{address}/insight', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://deep-index.moralis.io/api/v2.2/wallets/{address}/insight",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://deep-index.moralis.io/api/v2.2/wallets/{address}/insight"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://deep-index.moralis.io/api/v2.2/wallets/{address}/insight")
  .header("X-API-Key", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://deep-index.moralis.io/api/v2.2/wallets/{address}/insight")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body
{
  "address": "0xcB1C1FdE09f811B294172696404e88E658659905",
  "addressType": "evm",
  "walletAgeDays": 1314,
  "firstActivityAt": {
    "chain": "0x1",
    "blockNumber": "23583751",
    "blockTimestamp": "2025-10-15T14:41:23.000Z",
    "transactionHash": "0x...",
    "type": "tokenTransfer",
    "direction": "in"
  },
  "lastActivityAt": {
    "chain": "0x1",
    "blockNumber": "23583751",
    "blockTimestamp": "2025-10-15T14:41:23.000Z",
    "transactionHash": "0x...",
    "type": "tokenTransfer",
    "direction": "in"
  },
  "firstInitiatedAt": {
    "chain": "0x1",
    "blockNumber": "23583751",
    "blockTimestamp": "2025-10-15T14:41:23.000Z",
    "transactionHash": "0x...",
    "type": "tokenTransfer",
    "direction": "in"
  },
  "lastInitiatedAt": {
    "chain": "0x1",
    "blockNumber": "23583751",
    "blockTimestamp": "2025-10-15T14:41:23.000Z",
    "transactionHash": "0x...",
    "type": "tokenTransfer",
    "direction": "in"
  },
  "activeDays": 503,
  "activeChains": 9,
  "mostActiveChain": "0x1",
  "transactionsInitiated": 724,
  "transactionsInvolved": 754,
  "nativeTransfers": {
    "sent": 210,
    "received": 272,
    "total": 482
  },
  "erc20Transfers": {
    "sent": 210,
    "received": 272,
    "total": 482
  },
  "nftTransfers": {
    "sent": 210,
    "received": 272,
    "total": 482
  },
  "uniqueCounterparties": {
    "sentTo": 412,
    "receivedFrom": 615
  },
  "swapVolumeUsd": 11778.556304337722,
  "totalGasSpentUsd": "55.23",
  "avgGasPerTransactionUsd": "0.59",
  "nativeVolumeSentUsd": "4025.93",
  "nativeVolumeReceivedUsd": "2081.83",
  "nativeNetFlowUsd": "-1944.10",
  "uniqueTokensInteracted": 4,
  "contractsCreated": 58,
  "largestNativeTransferInUsd": "2061.94",
  "largestNativeTransferOutUsd": "1570.53",
  "chainBreakdown": [
    {
      "chain": "0x1",
      "walletAgeDays": 123,
      "firstActivityAt": {
        "chain": "0x1",
        "blockNumber": "23583751",
        "blockTimestamp": "2025-10-15T14:41:23.000Z",
        "transactionHash": "0x...",
        "type": "tokenTransfer",
        "direction": "in"
      },
      "lastActivityAt": {
        "chain": "0x1",
        "blockNumber": "23583751",
        "blockTimestamp": "2025-10-15T14:41:23.000Z",
        "transactionHash": "0x...",
        "type": "tokenTransfer",
        "direction": "in"
      },
      "firstInitiatedAt": {
        "chain": "0x1",
        "blockNumber": "23583751",
        "blockTimestamp": "2025-10-15T14:41:23.000Z",
        "transactionHash": "0x...",
        "type": "tokenTransfer",
        "direction": "in"
      },
      "lastInitiatedAt": {
        "chain": "0x1",
        "blockNumber": "23583751",
        "blockTimestamp": "2025-10-15T14:41:23.000Z",
        "transactionHash": "0x...",
        "type": "tokenTransfer",
        "direction": "in"
      },
      "activeDays": 123,
      "transactionsInitiated": 123,
      "transactionsInvolved": 123,
      "nativeTransfers": {
        "sent": 210,
        "received": 272,
        "total": 482
      },
      "erc20Transfers": {
        "sent": 210,
        "received": 272,
        "total": 482
      },
      "nftTransfers": {
        "sent": 210,
        "received": 272,
        "total": 482
      },
      "uniqueCounterparties": {
        "sentTo": 412,
        "receivedFrom": 615
      },
      "swapVolumeUsd": 123,
      "totalGasSpentNative": "<string>",
      "totalGasSpentUsd": "<string>",
      "avgGasPerTransactionNative": "<string>",
      "avgGasPerTransactionUsd": "<string>",
      "nativeVolumeSent": "<string>",
      "nativeVolumeSentUsd": "<string>",
      "nativeVolumeReceived": "<string>",
      "nativeVolumeReceivedUsd": "<string>",
      "nativeNetFlow": "<string>",
      "nativeNetFlowUsd": "<string>",
      "uniqueTokensInteracted": 123,
      "contractsCreated": 123,
      "largestNativeTransferIn": "<string>",
      "largestNativeTransferInUsd": "<string>",
      "largestNativeTransferOut": "<string>",
      "largestNativeTransferOutUsd": "<string>"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
default:test
required

Path Parameters

​
address
string
required

The wallet address to get insight for

Example:

"0xcB1C1FdE09f811B294172696404e88E658659905"

Query Parameters

​
chains
string[]

The chains to query. If not provided, aggregates across all supported chains.

Example:
["0x1", "0x89"]
​
includeChainBreakdown
boolean
default:false

When true, includes a per-chain breakdown array in the response with both native and USD values.

Response

200 - application/json

Returns wallet insight metrics.

​
address
string

The wallet address

Example:

"0xcB1C1FdE09f811B294172696404e88E658659905"

​
addressType
string

The type of address

Example:

"evm"

​
walletAgeDays
integer

Wallet age in days since first activity

Example:

1314

​
firstActivityAt
object | null
​
lastActivityAt
object | null
​
firstInitiatedAt
object | null
​
lastInitiatedAt
object | null
​
activeDays
integer

Number of unique active days

Example:

503

​
activeChains
integer

Number of unique chains the wallet is active on

Example:

9

​
mostActiveChain
string | null

The chain ID with the most active days

Example:

"0x1"

​
transactionsInitiated
integer

Number of transactions initiated by the wallet

Example:

724

​
transactionsInvolved
integer

Number of transactions involving the wallet

Example:

754

​
nativeTransfers
object
​
erc20Transfers
object
​
nftTransfers
object
​
uniqueCounterparties
object
​
swapVolumeUsd
number

Total swap volume in USD

Example:

11778.556304337722

​
totalGasSpentUsd
string

Total gas spent in USD across requested chains

Example:

"55.23"

​
avgGasPerTransactionUsd
string

Average gas per initiated transaction in USD

Example:

"0.59"

​
nativeVolumeSentUsd
string

Total native token volume sent in USD

Example:

"4025.93"

​
nativeVolumeReceivedUsd
string

Total native token volume received in USD

Example:

"2081.83"

​
nativeNetFlowUsd
string

Net native token flow in USD. Negative means outflow

Example:

"-1944.10"

​
uniqueTokensInteracted
integer

Number of unique ERC20 token contracts interacted with

Example:

4

​
contractsCreated
integer

Number of contracts created (deployed)

Example:

58

​
largestNativeTransferInUsd
string

Largest single native transfer received in USD

Example:

"2061.94"

​
largestNativeTransferOutUsd
string

Largest single native transfer sent in USD

Example:

"1570.53"

​
chainBreakdown
object[]

Per-chain breakdown with both native and USD values. Only included when includeChainBreakdown=true.