{"uid":"cap_2ve12IjgPm1sTe4wd5afw","slug":"mangrove-on-chain-token-flow-analytics-4821b63a","name":"Mangrove On-Chain Token Flow Analytics","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/on-chain/token/%7Bsymbol%7D/flows?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."},"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."}}},"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_GwdZPrYgxywF98rA1RY84","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":"Retrieves paginated on-chain token flow data for a given token symbol, filtered by wallet category, chain, and date range.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Smart money tracking for token","prompt":"Show me all smart money wallet flows for ARB on Ethereum between March 1 and March 31, 50 per page, starting at page 1."},{"title":"Exchange wallet activity analysis","prompt":"Get me on-chain token flows for ETH on base filtered to exchange wallets from April 1 to April 15, with 100 results per page."},{"title":"Whale movement monitoring","prompt":"Retrieve whale wallet flows for USDC on Ethereum from the last 7 days — show me page 1 with 25 results per page so I can spot big movements."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:35:15.954Z","isFirstParty":false,"canonicalSlug":"mangrove-on-chain-token-flow-analytics-4821b63a"}