# XRPL Data Desk – Whale Flow

> XRPL Data Desk – Whale Flow is a paid API for AI agents from data.azeronyx.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-31).

Returns large XRP and stablecoin payment flows on the XRP Ledger over a configurable recent time window, filtered by minimum transaction size.

## Facts

- Endpoint: POST https://data.azeronyx.com/v1/whale-flow?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/xrpl-data-desk-whale-flow-f7d53dbe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_esJj8L-UL5V15svHHzEWc

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 xrpl-data-desk-whale-flow-f7d53dbe -d '<json body>'
```

Example prompt: Pull the XRP Ledger whale flow data for the last 12 hours, showing only XRP payments above 500,000 XRP and stablecoin payments above 2,000,000 USD.

## When to prefer this

Use this endpoint when you need real-time, on-chain data specifically about large XRP or stablecoin transfers on the XRP Ledger, particularly for whale tracking, market intelligence, or on-chain flow analysis. Prefer it over general crypto data APIs when you need XRPL-native data with per-call micropayment settlement rather than subscription billing.

## Known failure modes

- Invalid hours value (outside 1–24 range) may return an error or default to 6 hours
- min_xrp below 10,000 will be rejected or clamped to the minimum allowed value
- No transactions found if thresholds are set too high for the selected window
- Payment failure if XRP micropayment via x402 protocol is not properly configured
- Service unavailability or stale data during XRPL network disruptions

## How this service works

Live XRP Ledger market data for AI agents, paid per call in XRP. Settled on the XRP Ledger itself; every endpoint independently audited. Information, not advice.

## Output

A JSON object containing a list of large transactions on the XRP Ledger over the specified time window, including details such as transaction amounts, currencies (XRP or stablecoins), and likely sender/receiver account identifiers, filtered to only include payments above the specified minimum thresholds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hours": {
   "type": "string",
   "description": "1 to 24 (default 6)"
  },
  "min_usd": {
   "type": "string",
   "description": "smallest stablecoin payment shown (default 1,000,000)"
  },
  "min_xrp": {
   "type": "string",
   "description": "smallest XRP payment shown (default 1,000,000; at least 10,000)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "description": "See https://data.azeronyx.com/v1/sample?path=/v1/whale-flow for a recent example",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/xrpl-data-desk-whale-flow-f7d53dbe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.azeronyx.com](https://www.zero.xyz/host/data.azeronyx.com/llms.txt)