Financial Data

Token balances, net worth, and portfolio information

Wallet Net Worth

get

Calculate total net worth across multiple blockchain networks

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}$

chainsstringOptional

Comma-separated list of blockchain networks

Example: eth,polygon,bsc

exclude_spambooleanOptional

Exclude spam tokens/NFTs from results

Default: true

exclude_unverified_contractsbooleanOptional

Exclude unverified contracts from results

Default: true

bustCachebooleanOptional

Force cache refresh

Default: false

Responses

200

Net worth calculation

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/net-worth

HTTPcURLJavaScriptPython

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

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

Token Balances

get

Get all token balances with current prices and portfolio percentages

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:

limitinteger · min: 1 · max: 100Optional

Maximum number of items to return

Default: 50

exclude_spambooleanOptional

Exclude spam tokens/NFTs from results

Default: true

exclude_unverified_contractsbooleanOptional

Exclude unverified contracts from results

Default: true

cursorstringOptional

Pagination cursor for next page

Responses

200

Token balances with prices

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

HTTPcURLJavaScriptPython

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

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