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.

post

/api/metrics

Authorizations

Body

wallet_addressstring

Wallet address to query.

Example: 0xYourWalletAddressHere

chainsstring[]

Example: ["ethereum","polygon","arbitrum"]

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-v2.idefi.ai/api/metrics' \
  --header 'Authorization: Bearer UID' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_address": "0xYourWalletAddressHere",
    "chains": [
      "ethereum",
      "polygon",
      "arbitrum"
    ]
  }'

200

400

200

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

Successful response with wallet metrics.