# Mangrove On-Chain DEX Trades by Token Symbol

> Mangrove On-Chain DEX Trades by Token Symbol 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).

Fetches paginated DEX (decentralized exchange) trade history for a given token symbol on a specified blockchain, filtered by date range.

## Facts

- Endpoint: POST https://api.mangrovedeveloper.ai/api/v1/on-chain/token/%7Bsymbol%7D/dex-trades?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-dex-trades-by-token-symbol-51af3d90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QZO_hpoDvZaz95NVh3-sk

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-dex-trades-by-token-symbol-51af3d90 -d '<json body>'
```

Example prompt: Pull the DEX trade history for the token symbol WETH on the Base chain from January 1 2025 to January 31 2025, showing 50 trades per page starting from page 1.

## When to prefer this

Use this endpoint when you need historical or recent DEX trade records for a specific token symbol on a named blockchain, especially with date-range filtering and pagination. Prefer this over generic blockchain explorers when you need structured, paginated trade data ready for analysis or integration into an AI workflow. It is best suited for DeFi research, trading analytics, anomaly detection, and on-chain data pipelines.

## Known failure modes

- Invalid or unrecognized token symbol returns empty results or 404
- Unsupported chain slug returns an error or empty dataset
- date_from/date_to in wrong format causes a 400 bad request
- Page number beyond available data returns empty list
- Payment not fulfilled causes 402 Payment Required response
- Upstream on-chain data provider outage causes 502 or timeout

## How this service works

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

## Output

Returns a paginated list of on-chain DEX trade records for the specified token symbol on the given blockchain, scoped to the requested date window. Each record typically includes trade details such as transaction hash, amounts, prices, timestamps, and counterparties, as sourced from the upstream on-chain data provider.

## 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."
  },
  "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-dex-trades-by-token-symbol-51af3d90/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)