{"uid":"cap_-aV2E-O0PjbwlGout0lCI","slug":"mangrove-smart-money-historical-holdings-bb968b17","name":"Mangrove Smart Money Historical Holdings","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/on-chain/smart-money/historical-holdings?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"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_gwVNtTZUU5gns2UwBUpiL","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 historical on-chain portfolio holdings data for 'smart money' wallets across specified blockchains over a date range.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Q1 crypto portfolio research","prompt":"Get me the smart money historical holdings on Ethereum from January 1 to March 31 2025, 100 per page, so I can see what top wallets were holding in Q1."},{"title":"Multi-chain smart wallet tracking","prompt":"Fetch historical smart money holdings across Ethereum, Base, and Solana from December 1 to December 31 2024 — I want to compare what leading wallets held across chains at year end."},{"title":"Trend analysis before a token launch","prompt":"Retrieve smart money on-chain holdings from October 1 to November 15 2024, filtered and ordered by largest positions, so I can spot any early accumulation trends before the market moved."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:36:24.344Z","isFirstParty":false,"canonicalSlug":"mangrove-smart-money-historical-holdings-bb968b17"}