# Kronos by ForgeMesh — Whale Alert / Exchange Flow Monitor

> Kronos by ForgeMesh — Whale Alert / Exchange Flow Monitor is a paid API for AI agents from kronos.forgemesh.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns large on-chain transaction alerts and exchange flow signals for a specified blockchain over a configurable time window, paid via x402 micropayments.

## Facts

- Endpoint: GET https://kronos.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/kronos-by-forgemesh-whale-alert-exchange-flow-monitor-d113e46b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QIGG4-db_mI82M7VMMcwO

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 kronos-by-forgemesh-whale-alert-exchange-flow-monitor-d113e46b
```

Example prompt: Check for any whale alerts or large exchange flows on Base over the last 4 hours — I want to see if there are big moves into or out of any major venue.

## When to prefer this

Choose this endpoint when you need real-time or near-real-time detection of large on-chain transactions and exchange flows across Ethereum, Base, or Arbitrum, especially in autonomous agent pipelines that can handle x402 micropayment flows. Prefer this over generic market data APIs when you need whale-specific signals (exchange venue, direction, USD value) rather than price feeds or order book data.

## Known failure modes

- Payment not received or insufficient USDC — x402 payment required error returned
- Invalid chain value outside allowed enum (ethereum, base, arbitrum) — validation error
- Hours parameter outside 1–168 range — request rejected
- No whale alerts in the requested window — returns empty alerts array with alert_count 0
- Network or upstream data provider unavailability — 5xx error

## How this service works

Paid crypto market-intelligence API for autonomous agents. Calibrated ranges, signal context, risk state, decision journals, and outcome audits via x402 micropayments on Base.

## Output

Returns a JSON object with the queried chain name, the time window in hours, a count of alerts found, and an array of alert objects. Each alert includes the type (e.g. exchange_flow), venue name (e.g. Coinbase), direction (in/out), and USD value of the transaction.

## 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/kronos-by-forgemesh-whale-alert-exchange-flow-monitor-d113e46b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kronos.forgemesh.io](https://www.zero.xyz/host/kronos.forgemesh.io/llms.txt)