Metrics

In partnership with iDEFi.AI

Fetch Wallet Metrics

Retrieve wallet metrics for a specified wallet address, including USD balance, positions, transaction analysis, NFT summary, and uncommon addresses.

POSThttps://api-v2.idefi.ai/api/metrics

Authorization

user_uidAuth

Body

application/json

wallet_addressstring

Wallet address to query.

Example: "0xYourWalletAddressHere"

chainsarray of string

Optional list of blockchain networks to query.

Response

200400

Successful response with wallet metrics.

Body

application/json

wallet_addressstring

Example: "0xYourWalletAddressHere"

user_uidstring

The authenticated user's unique identifier (UID).

Example: "abc123-uid"

financialMetricsobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api-v2.idefi.ai/api/metrics', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer UID",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400

{
  "wallet_address": "0xYourWalletAddressHere",
  "user_uid": "abc123-uid",
  "financialMetrics": {
    "balance": 2500.75,
    "totalTransactions": 400,
    "transactionsByLayer": {
      "Layer1": 300,
      "Layer2": 100
    },
    "interactingWallets": 85,
    "mostActiveWallet": {
      "address": "0xDEF456",
      "transactionCount": 50
    },
    "behaviorOverview": {
      "overview": {
        "Low": 40,
        "Moderate": 25,
        "High": 15,
        "Uncommon": 5
      },
      "markedUncommonWallets": [
        "0xABC123"
      ],
      "totalUncommon": 5
    },
    "nftSummary": {
      "nftCount": 12,
      "nftValueEst": 3200
    },
    "uncommonAddressesInTx": [
      "0x1234567890abcdef1234567890abcdef12345678"
    ]
  }
}