# AiToollab Whale Address Lookup

> AiToollab Whale Address Lookup is a paid API for AI agents from api.aitoollab.top, paid per call via x402, $0.08/call, status unknown (last checked 2026-10-07).

Looks up blockchain wallet address metadata including exchange label, risk signals, balance, and transaction count for a given address

## Facts

- Endpoint: GET https://api.aitoollab.top/api/whale/address/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-07
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aitoollab-whale-address-lookup-8e0103e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sviR2jg8pz6N25CVHihJ5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aitoollab-whale-address-lookup-8e0103e9
```

Example prompt: Can you look up the blockchain address 0xABC123... and tell me if it belongs to an exchange, what its risk signals are, its total USD balance, and how many transactions it has?

## When to prefer this

Use this endpoint when you need on-chain wallet intelligence for a specific blockchain address, including exchange identification, risk profiling, balance, and transaction history. Prefer this over generic block explorers when you need structured, machine-readable output with risk signals and entity labels.

## Known failure modes

- Invalid or malformed address returns 400 error
- Unknown address with no indexed data may return empty or null fields
- Rate limiting or payment failure returns 402 Payment Required
- Address not found on supported chains returns 404

## How this service works

AiToollab，普通人用AI做副业的实战平台。收录10+AI副业方向、50+提示词模板、真实赚钱案例。每周更新，找方向、找工具、找案例，一站搞定。

## Output

Returns a JSON object with the address type (e.g. 'exchange'), a human-readable label (e.g. 'Binance Hot Wallet'), an array of risk signals, the total balance in USD, and the total transaction count for the queried address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "type": "exchange",
  "label": "Binance Hot Wallet",
  "address": "0x...",
  "risk_signals": [],
  "total_balance_usd": 1000000000,
  "transaction_count": 50000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aitoollab-whale-address-lookup-8e0103e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aitoollab.top](https://www.zero.xyz/host/api.aitoollab.top/llms.txt)