Metrics

In partnership with iDEFi.AI

Fetch Wallet Metrics

post

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

Authorizations

Body

wallet_addressstringOptional

Wallet address to query.

Example: 0xYourWalletAddressHere

chainsstring[]Optional

Optional list of blockchain networks to query.

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

Responses

200

Successful response with wallet metrics.

application/json

400

Bad request due to missing or invalid parameters.

application/json

post

HTTPcURLJavaScriptPython

POST /api/metrics HTTP/1.1
Host: api-v2.idefi.ai
Authorization: Bearer UID
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "wallet_address": "0xYourWalletAddressHere",
  "chains": [
    "ethereum",
    "polygon",
    "arbitrum"
  ]
}

{
  "wallet_address": "0xYourWalletAddressHere",
  "user_uid": "abc123-uid",
  "financialMetrics": {
    "balance": 2500.75,
    "positions": {
      "ANY_ADDITIONAL_PROPERTY": {
        "value": 1250.35,
        "percentage": 50
      }
    },
    "totalTransactions": 400,
    "transactionsByChain": {
      "ANY_ADDITIONAL_PROPERTY": 200
    },
    "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"
    ]
  }
}