# ForgeMesh Crypto Whale & Capital Flow Alerts

> ForgeMesh Crypto Whale & Capital Flow Alerts is a paid API for AI agents from crypto.forgemesh.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns whale, CEX, bridge, and stablecoin flow alerts for a specified blockchain and time window, including direction, venue, and USD value of large capital movements.

## Facts

- Endpoint: GET https://crypto.forgemesh.io/api/whale
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-crypto-whale-capital-flow-alerts-2835ae09
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BAzShZL8yhMv5QeIjZP1-

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 forgemesh-crypto-whale-capital-flow-alerts-2835ae09
```

Example prompt: Show me all whale, CEX, bridge, and stablecoin flow alerts on Ethereum from the last 48 hours so I can see if any big capital movements are setting up a price move.

## When to prefer this

Use this endpoint when you need to detect large capital movements on Ethereum, Base, or Arbitrum before they impact price, specifically looking for whale wallet transfers, CEX inflows/outflows, cross-chain bridge flows, or stablecoin movements — and want directional and venue context for each alert.

## Known failure modes

- Invalid chain value (not ethereum/base/arbitrum) — likely 400 or validation error
- Hours out of range (less than 1 or greater than 168) — validation error
- No alerts found for the window — empty alerts array returned
- Payment not processed or insufficient USDC — 402 payment required
- Service unavailable or upstream data lag — 5xx error

## How this service works

Returns whale, CEX, bridge, and stablecoin flow alerts for a chosen chain and lookback window, each with direction, venue, and USD value — use it to catch large capital movements before they move price. Typical agent tasks: check for a large exchange inflow on Base, monitor bridge flows into or out of a chain, track stablecoin issuer mint or burn events, or add on-chain flow context to a crypto market-intelligence pipeline. Configurable 1-168 hour lookback, USDC on Base via x402.

## Output

An array of capital flow alerts for the chosen chain and time window, each specifying the alert type (whale, CEX, bridge, or stablecoin), direction, venue, and USD value, plus summary fields for total alert count and the requested window in hours.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arbitrum"
       ],
       "type": "string"
      },
      "hours": {
       "type": "number",
       "maximum": 168,
       "minimum": 1
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "chain": {
       "type": "string"
      },
      "alerts": {
       "type": "array"
      },
      "alert_count": {
       "type": "number"
      },
      "window_hours": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "alerts": [
   {
    "type": "exchange_flow",
    "venue": "Coinbase",
    "direction": "in",
    "value_usd": 750000
   }
  ],
  "alert_count": 2,
  "window_hours": 4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-crypto-whale-capital-flow-alerts-2835ae09/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from crypto.forgemesh.io](https://www.zero.xyz/host/crypto.forgemesh.io/llms.txt)