# Mangrove Smart Money Historical Holdings

> Mangrove Smart Money Historical Holdings 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 historical on-chain portfolio holdings data for 'smart money' wallets across specified blockchains over a date range.

## Facts

- Endpoint: POST https://api.mangrovedeveloper.ai/api/v1/on-chain/smart-money/historical-holdings?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-smart-money-historical-holdings-bb968b17
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-aV2E-O0PjbwlGout0lCI

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-smart-money-historical-holdings-bb968b17 -d '<json body>'
```

Example prompt: Pull the smart money historical holdings on Ethereum and Base from January 1 to March 31 2025, page 1 with 100 results per page — I want to see what top on-chain wallets were positioned in during Q1.

## When to prefer this

Use this endpoint when you need time-series historical data on what smart money wallets held on-chain, especially when querying across multiple blockchains or needing paginated, filtered, and ordered results. Prefer this over live/current holdings endpoints when historical trend analysis or retrospective portfolio research is the goal.

## Known failure modes

- Invalid or missing date_from/date_to formats result in a 400 error
- Unsupported chain identifiers may return empty results or errors
- Pagination out of bounds returns empty result set
- Malformed filter or order_by objects may cause upstream provider errors
- Payment not processed (x402 flow failure) prevents access
- Rate limiting or quota exceeded on the upstream data provider

## How this service works

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

## Output

A paginated list of historical on-chain holdings records attributed to smart money wallets, covering the requested date range and chains. Each record likely includes wallet addresses, asset identifiers, quantities held, chain information, and timestamps. Results respect the requested page, per_page, filters, and ordering.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer",
   "default": 1,
   "description": "Page number for pagination."
  },
  "chains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Optional list of chains to include."
  },
  "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-smart-money-historical-holdings-bb968b17/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)