Analytics

Wallet statistics and activity metrics

Wallet Statistics

get

Get comprehensive wallet activity statistics and metrics

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

Wallet statistics

application/json

400

Bad request - missing or invalid parameters

application/json

404

Wallet not found or insufficient transaction history

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

503

Stats data unavailable

application/json

get

/api/wallet/stats

HTTPcURLJavaScriptPython

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

{
  "nfts": "text",
  "collections": "text",
  "transactions": {
    "total": "text"
  },
  "nft_transfers": {
    "total": "text"
  },
  "token_transfers": {
    "total": "text"
  }
}

Multi-Chain Activity

get

Get wallet activity across different blockchain networks

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

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

bustCachebooleanOptional

Force cache refresh

Default: false

Responses

200

Multi-chain activity data

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/chain-activity

HTTPcURLJavaScriptPython

GET /api/wallet/chain-activity?address=0x742d35cc6634C0532925a3b8D7aa5ac000000000 HTTP/1.1
Host: kairolabs.io
Accept: */*

{
  "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"
}

Money Flow Analysis

get

Analyze money flow patterns and counterparty relationships

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

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

chainstring · enumOptional

Blockchain network identifier

Default: ethPossible values:

limitinteger · min: 1 · max: 1000Optional

Maximum number of transactions to analyze

Default: 500

min_transactionsinteger · min: 1Optional

Minimum transactions with counterparty to include

Default: 2

Responses

200

Money flow analysis

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/money-flow

HTTPcURLJavaScriptPython

GET /api/wallet/money-flow?address=0x742d35cc6634C0532925a3b8D7aa5ac000000000 HTTP/1.1
Host: kairolabs.io
Accept: */*

{
  "success": true,
  "data": {
    "address": "text",
    "chain": "text",
    "totalAnalyzed": 1,
    "timeRange": {
      "from": "2025-12-16T20:56:13.098Z",
      "to": "2025-12-16T20:56:13.098Z"
    },
    "summary": {
      "totalInboundUsd": 1,
      "totalOutboundUsd": 1,
      "netFlowUsd": 1,
      "uniqueCounterparties": 1
    },
    "topRecipients": [
      {
        "address": "text",
        "label": "text",
        "entity": "text",
        "totalVolumeUsd": 1,
        "netFlowUsd": 1,
        "transactionCount": 1,
        "firstInteraction": "2025-12-16T20:56:13.098Z",
        "lastInteraction": "2025-12-16T20:56:13.098Z",
        "interactions": {
          "inbound": {
            "count": 1,
            "totalUsd": 1
          },
          "outbound": {
            "count": 1,
            "totalUsd": 1
          }
        }
      }
    ]
  }
}