{"uid":"cap_IPQ7R8PSIJEFRlfuyi-yR","slug":"hyperliquid-smart-money-inflow-tracker-088b37f5","name":"Hyperliquid Smart Money Inflow Tracker","description":"Finds the top-ROI accounts on Hyperliquid's public perp leaderboard (week, month or all-time window, with a minimum account size) and reads their live open positions from Hyperliquid's public info API, then sums net long/short USD exposure per coin. Shows where the best-performing Hyperliquid traders are positioned now. Hyperliquid perps only, not spot wallets on other chains; not investment advice.","url":"https://api.fadeandco.workers.dev/api/agent-intel/smart-money-inflow-tracker?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"top":{"type":"string","description":"How many top-ROI accounts to read, 3 to 25 (default 15)"},"coin":{"type":"string","description":"Optional coin symbol to focus on, e.g. BTC"},"window":{"type":"string","description":"Ranking window: day, week, month or allTime (default month)"},"minAccountUsd":{"type":"string","description":"Minimum account value in USD for an account to count, 10000 to 100000000 (default 100000)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"note":"Top accounts by ROI on Hyperliquid's leaderboard for the chosen window; positions are live perp positions. Not investment advice.","coins":[{"bias":"NET_SHORT","coin":"SOL","netUsd":-145.66,"longUsd":0,"shortUsd":145.66,"longWallets":0,"shortWallets":1},{"bias":"NET_SHORT","coin":"ETH","netUsd":-115.89,"longUsd":0,"shortUsd":115.89,"longWallets":0,"shortWallets":1}],"source":"https://stats-data.hyperliquid.xyz/Mainnet/leaderboard","window":"month","wallets":[{"roi":285.9957,"pnlUsd":28599.57,"address":"0xc8e006b05694165e5459d5ac297c6857f97d8f23","positions":[],"volumeUsd":26270.76,"displayName":null,"accountValueUsd":145499.98},{"roi":259.5142,"pnlUsd":25951.42,"address":"0xfe8c8076596dd917a20a31007ced69ce339129a1","positions":[],"volumeUsd":7295732.78,"displayName":"WOOF","accountValueUsd":187708.63}],"checkedAt":"2026-10-23T09:35:21.531Z","walletsRead":15,"minAccountUsd":100000,"leaderboardAccounts":47632}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LZRR4Egf5VgMKgNRyAiJX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches top-ROI Hyperliquid perp traders from the public leaderboard and aggregates their live open positions into net long/short USD exposure per coin","exampleAgentPrompt":"Pull the live perp positions of the top 10 Hyperliquid traders by ROI over the past month with a minimum account size of $500,000, and tell me which coins have the biggest net long or short bias right now.","exampleUseCases":[{"title":"Spot dominant smart money bias before trading","prompt":"I want to know where the top 20 Hyperliquid traders by monthly ROI are positioned — show me which coins have the biggest net long and short exposure so I can see if smart money is bullish or bearish overall."},{"title":"Focus on BTC positioning of elite traders","prompt":"Check what the top 15 Hyperliquid leaderboard traders with at least $250,000 in their accounts are doing with BTC perps right now — are they net long or net short?"},{"title":"Weekly leaderboard smart money scan","prompt":"Give me a smart money positioning snapshot using the weekly Hyperliquid leaderboard — top 25 accounts, minimum $100,000 account size — and tell me which coins they're most aggressively positioned in."}],"resultDescription":"Returns a list of coins with net USD long/short exposure and bias (NET_LONG or NET_SHORT), plus individual wallet details including ROI, PnL, address, display name, account value, volume, and open positions. Also includes metadata: leaderboard window, number of wallets read, minimum account threshold, timestamp, and source URL.","failureModes":["Hyperliquid public API unavailable — returns error or empty data","No accounts meet the minimum account size threshold — returns empty wallet list","Invalid window parameter value — may return error or default behavior","top parameter out of range (below 3 or above 25) — may be clamped or rejected","Top ROI wallets have no open positions — coins array may be empty"],"whenToPreferThis":"Choose this endpoint when you need aggregated smart money positioning data from Hyperliquid perp markets specifically, ranked by ROI performance. It is ideal for detecting directional bias (long vs short) across top-performing traders without manually querying individual wallets. Prefer it over generic on-chain analytics tools when the focus is Hyperliquid perpetual futures leaderboard accounts only. Not suitable for spot wallet holdings, other chains, or CEX data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:20.754Z","isFirstParty":false,"canonicalSlug":"hyperliquid-smart-money-inflow-tracker-088b37f5"}