# Mangrove On-Chain Token Flow Analytics

> Mangrove On-Chain Token Flow Analytics is a paid API for AI agents from api.mangrovedeveloper.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-04).

Retrieves paginated on-chain token flow data for a given token symbol, filtered by wallet category, chain, and date range.

## Facts

- Endpoint: POST https://api.mangrovedeveloper.ai/api/v1/on-chain/token/%7Bsymbol%7D/flows?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mangrove-on-chain-token-flow-analytics-4821b63a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2ve12IjgPm1sTe4wd5afw

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 mangrove-on-chain-token-flow-analytics-4821b63a -d '<json body>'
```

Example prompt: Pull the on-chain token flows for USDC on Ethereum from January 1 to January 31, filtered to whale wallets, showing 50 results per page starting at page 1.

## When to prefer this

Use this endpoint when you need on-chain token flow data segmented by specific wallet categories (whales, smart money, exchanges, public figures, top holders) on a named blockchain. It is particularly useful for agents doing DeFi intelligence, market analysis, or tracking large token movements across a date range with pagination support.

## Known failure modes

- Invalid or unrecognized token symbol returns an error or empty results
- Unsupported chain slug causes a validation error
- Invalid date format for date_from or date_to causes a 400 error
- Unknown wallet label value causes a filter error
- Page number out of range returns empty result set
- Upstream provider unavailable returns a 502 or timeout

## How this service works

Developer references for Mangrove Agent, API contracts, MCP and AI integrations.

## Output

Returns paginated on-chain token flow records for the specified token symbol, filtered by chain, wallet category (smart_money, exchange, whale, public_figure, top_100_holders), and date window. Each page includes flow entries that may contain transaction details, wallet addresses, amounts, and timestamps, along with pagination metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "description": "Page number for pagination."
  },
  "chain": {
   "type": "string",
   "default": "ethereum",
   "description": "Chain name or slug, e.g. ethereum or base."
  },
  "label": {
   "type": "string",
   "description": "Wallet category: smart_money, exchange, whale, public_figure, or top_100_holders."
  },
  "date_to": {
   "type": "string",
   "description": "ISO date string for the end of the window."
  },
  "filters": {
   "type": "object",
   "description": "Optional filter object passed through to the upstream provider."
  },
  "order_by": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "description": "Optional ordering list passed through to the upstream provider."
  },
  "per_page": {
   "type": "integer",
   "default": 100,
   "description": "Page size for pagination."
  },
  "date_from": {
   "type": "string",
   "description": "ISO date string for the start of the window."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mangrove-on-chain-token-flow-analytics-4821b63a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mangrovedeveloper.ai](https://www.zero.xyz/host/api.mangrovedeveloper.ai/llms.txt)