Identity & Labels

Wallet classification, labeling, and ENS resolution

Wallet Labels

get

Get wallet classification labels and categories

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

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

chainstring · enumOptional

Blockchain network identifier

Default: ethPossible values:

forcebooleanOptional

Force immediate re-analysis of wallet

Default: false

Responses

200

Wallet labels and categories

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/labels

HTTPcURLJavaScriptPython

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

{
  "address": "text",
  "chain": "text",
  "primaryLabel": "text",
  "tags": [
    "text"
  ],
  "isAnalyzing": true,
  "lastUpdated": "2025-12-16T20:56:21.081Z",
  "needsUpdate": true
}

Update Wallet Labels

post

Force update of wallet classification and labels

Body

application/json

addressstringRequired

Ethereum wallet address

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

chainstringOptional

Blockchain network

Default: eth

Responses

200

Updated wallet labels

application/json

400

Bad request - missing or invalid parameters

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

post

/api/wallet/labels

HTTPcURLJavaScriptPython

POST /api/wallet/labels HTTP/1.1
Host: kairolabs.io
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "address": "text",
  "chain": "eth"
}

{
  "address": "text",
  "chain": "text",
  "primaryLabel": "text",
  "tags": [
    "text"
  ],
  "isAnalyzing": true,
  "lastUpdated": "2025-12-16T20:56:21.081Z",
  "needsUpdate": true
}

Label Statistics

get

Get aggregated statistics about wallet labels and categories

Responses

200

Label statistics

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/api/wallet/labels/stats

HTTPcURLJavaScriptPython

GET /api/wallet/labels/stats HTTP/1.1
Host: kairolabs.io
Accept: */*

{
  "totalLabeled": 1,
  "totalAnalyzing": 1,
  "labelDistribution": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "categoryDistribution": {
    "ANY_ADDITIONAL_PROPERTY": 1
  }
}

ENS Name Resolution

get

Resolve ENS name for a given Ethereum address

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

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

Responses

200

ENS name resolution result

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/ens

HTTPcURLJavaScriptPython

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

{
  "name": "text"
}