{"uid":"cap_lO-5sreM3_0g1GiXsHtN1","slug":"mangrove-smart-money-perp-trades-860dead6","name":"Mangrove Smart Money Perp Trades","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/on-chain/smart-money/perp-trades?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"page":{"type":"integer","default":1,"description":"Page number for pagination."},"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."}}},"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_KKTvhXpEBZ9U8RNpvAQYC","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 on-chain perpetual futures trades made by smart money wallets, with optional filtering and ordering.","exampleAgentPrompt":"Pull the latest smart money perpetual futures trades from Mangrove's on-chain data — give me page 1 with 50 trades per page so I can see what the big wallets are doing in the perp markets right now.","exampleUseCases":[{"title":"Monitor smart money perp positioning","prompt":"Show me the most recent perpetual futures trades made by smart money wallets on-chain — page 1, 100 trades per page, so I can see where the big players are positioning themselves right now."},{"title":"Filter smart money perp trades by asset","prompt":"Query Mangrove's smart money perp trades and filter for BTC perpetual trades only, 50 results per page starting from page 1 — I want to see what whale traders are doing with Bitcoin perps today."},{"title":"Paginate through smart money perp history","prompt":"Get me page 3 of smart money on-chain perp trades with 25 trades per page so I can scroll through recent activity and spot any patterns in how these wallets are trading derivatives."}],"resultDescription":"Returns a paginated list of on-chain perpetual futures trades attributed to smart money wallets, including trade details such as asset, size, direction, and timestamp, subject to any applied filters and ordering.","failureModes":["Invalid page or per_page values may return a 400 error","Unsupported filter fields may be rejected or silently ignored by upstream provider","Payment not received results in 402 Payment Required","Rate limiting or upstream provider downtime may cause 503 errors","Empty result set returned if no trades match the applied filters"],"whenToPreferThis":"Use this endpoint when you need on-chain perpetual futures trade data specifically attributed to smart money wallets, with support for pagination and custom filtering. Prefer this over generic DEX trade feeds when you want curated whale or institutional-grade wallet activity in the perp market.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:36:13.014Z","isFirstParty":false,"canonicalSlug":"mangrove-smart-money-perp-trades-860dead6"}