# LensCrypt Whale Heatmap

> LensCrypt Whale Heatmap is a paid API for AI agents from tolens.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a heatmap of on-chain whale activity, visualizing where large holders are concentrating buying or selling pressure across tokens or time periods.

## Facts

- Endpoint: GET https://tolens.vercel.app/api/whale/heatmap
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lenscrypt-whale-heatmap-ebc6e5b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WxJt6hU3CeHpcunLlZm03

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 lenscrypt-whale-heatmap-ebc6e5b9
```

Example prompt: Show me a whale activity heatmap right now — I want to see where large wallets are concentrating their buys and sells across tokens on-chain.

## When to prefer this

Use this endpoint when you need a visual or structured distribution of whale activity rather than individual whale wallet alerts or single-transaction tracking. Best for understanding macro-level large-holder sentiment and identifying accumulation or distribution zones across multiple tokens simultaneously.

## Known failure modes

- Missing or malformed chain/token parameters returns a 400 error
- Payment not sent or insufficient USDC balance returns a 402 payment required
- No whale activity in the requested timeframe returns an empty or minimal dataset
- Rate limiting or upstream data source unavailability returns a 503
- Invalid token address format returns a validation error

## How this service works

81 paid REST endpoints covering wallet analytics, DeFi yields, token safety, smart money tracking, whale alerts, sniper detection, GMX perps, Solana tools, protocol stats, gas tracking, DEX quotes, NFT analytics, social signals, and 8 AI-powered endpoints (MiMo V2.5). Pay USDC via x402 protocol on Base.

## Output

A heatmap dataset showing where whale wallets are most active, with concentration data across tokens or time buckets, buy/sell pressure indicators, and large-holder transaction density signals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lenscrypt-whale-heatmap-ebc6e5b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tolens.vercel.app](https://www.zero.xyz/host/tolens.vercel.app/llms.txt)