Comprehensive Data

Complete wallet analysis combining multiple data sources

Complete Wallet Overview

get

Get comprehensive wallet data combining multiple data sources

Authorizations

ApiKeyAuth

AuthorizationstringOptional

API key authentication for higher rate limits. To use this authentication:

1. Generate an API key at https://kairolabs.io/settings
2. Include the API key in the Authorization header as a Bearer token
3. Format: Authorization: Bearer wi_your_api_key_here

API keys provide increased rate limits compared to unauthenticated requests.

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

Example: 0x742d35cc6634C0532925a3b8D7aa5ac000000000Pattern: ^0x[a-fA-F0-9]{40}$

chainstring · enumOptional

Blockchain network identifier

Default: ethPossible values:

Responses

200

Complete wallet overview

application/json

400

Bad request - missing or invalid parameters

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/api/wallet/overview

HTTPcURLJavaScriptPython

GET /api/wallet/overview?address=0x742d35cc6634C0532925a3b8D7aa5ac000000000 HTTP/1.1
Host: kairolabs.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "netWorth": {
    "total_networth_usd": "text",
    "chains": [
      {
        "chain": "text",
        "native_balance": "text",
        "native_balance_formatted": "text",
        "native_balance_usd": "text",
        "token_balance_usd": "text",
        "networth_usd": "text"
      }
    ]
  },
  "tokenBalances": {
    "result": [
      {
        "token_address": "text",
        "symbol": "text",
        "name": "text",
        "logo": "text",
        "thumbnail": "text",
        "decimals": "text",
        "balance": "text",
        "possible_spam": "text",
        "verified_contract": true,
        "balance_formatted": "text",
        "usd_price": 1,
        "usd_price_24hr_percent_change": 1,
        "usd_price_24hr_usd_change": 1,
        "usd_value": 1,
        "usd_value_24hr_usd_change": 1,
        "native_token": true,
        "portfolio_percentage": 1
      }
    ],
    "cursor": "text",
    "page": 1,
    "page_size": 1
  },
  "walletStats": {
    "nfts": "text",
    "collections": "text",
    "transactions": {
      "total": "text"
    },
    "nft_transfers": {
      "total": "text"
    },
    "token_transfers": {
      "total": "text"
    }
  },
  "chainActivity": {
    "address": "text",
    "supportedChains": [
      "text"
    ],
    "chainActivities": [
      {
        "chainName": "text",
        "chainId": "text",
        "txCount": 1,
        "firstTx": {
          "block_number": "text",
          "block_timestamp": "text",
          "transaction_hash": "text"
        },
        "lastTx": {
          "block_number": "text",
          "block_timestamp": "text",
          "transaction_hash": "text"
        }
      }
    ],
    "totalChains": 1,
    "totalTransactions": 1,
    "mostActiveChain": "text"
  },
  "defiSummary": {
    "active_protocols": "text",
    "total_positions": "text",
    "total_usd_value": "text",
    "total_unclaimed_usd_value": "text",
    "protocols": {
      "total_usd_value": "text",
      "total_unclaimed_usd_value": "text",
      "positions": "text"
    }
  },
  "pnlSummary": {
    "total_count_of_trades": 1,
    "total_trade_volume": "text",
    "total_realized_profit_usd": "text",
    "total_realized_profit_percentage": 1,
    "total_buys": 1,
    "total_sells": 1,
    "total_sold_volume_usd": "text",
    "total_bought_volume_usd": "text"
  },
  "ensName": {
    "name": "text"
  }
}