{"uid":"cap_QZO_hpoDvZaz95NVh3-sk","slug":"mangrove-on-chain-dex-trades-by-token-symbol-51af3d90","name":"Mangrove On-Chain DEX Trades by Token Symbol","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/on-chain/token/%7Bsymbol%7D/dex-trades?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7u_0FJp1kLm3eZ-34ce6-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches paginated DEX (decentralized exchange) trade history for a given token symbol on a specified blockchain, filtered by date range.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Token DEX activity research","prompt":"Get me all DEX trades for the USDC token on Ethereum between March 1 2025 and March 15 2025, 100 per page, starting at page 1."},{"title":"DeFi analytics dashboard feed","prompt":"Fetch the first page of on-chain DEX trades for ARB on the Arbitrum chain from April 1 2025 to April 30 2025, 50 trades per page, so I can build a trading volume chart."},{"title":"Unusual trading pattern detection","prompt":"Query DEX swap records for the PEPE token on Ethereum for today, page 1 with 100 results per page — I want to check if there's been any unusual trading activity."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:34:25.254Z","isFirstParty":false,"canonicalSlug":"mangrove-on-chain-dex-trades-by-token-symbol-51af3d90"}