{"uid":"cap_5HOZg0LrwMM7cnEu8df4H","slug":"annalist-smart-money-perp-positioning-a1481294","name":"Annalist Smart Money Perp Positioning","description":"Signed data for AI agents, paid per call over x402. Hyperliquid crowd state, smart money and liquidations with what historically happened next, plus independent checks of x402 services and MCP servers.","url":"https://api.annalist.dev/v1/smart/perp?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":["coin"],"properties":{"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"coin":"SOL","flags":[],"net_usd":12500000,"net_share":0.42,"traders_long":41,"traders_short":18}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C2WWgg7sspBWmQacQWvEy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated smart-money positioning data for a single Hyperliquid perpetual — long/short wallet counts, USD exposure, net delta, concentration, leverage, and comparison with crowd funding/price dynamics.","exampleAgentPrompt":"Before I open a long on the ETH perp on Hyperliquid, can you check how the most profitable traders there are positioned — are they net long or short, how exposed are they in USD, and is the trade crowded against them?","exampleUseCases":[{"title":"Pre-trade smart money check","prompt":"I'm thinking of going long on SOL perp on Hyperliquid — can you pull up how the top profitable wallets are positioned in SOL, their net USD exposure, and whether there's any crowd vs smart-money divergence I should know about?"},{"title":"Crowded trade risk screen","prompt":"Before I short BTC perp, tell me if smart money is heavily positioned long in BTC on Hyperliquid and whether the crowd is on the other side — I want to know if I'd be trading with or against the smart-money cohort."},{"title":"Leverage and concentration scouting","prompt":"How concentrated is smart money in the HYPE perp on Hyperliquid right now? I want to know the largest wallet's share, how many traders are in the cohort, and what leverage they're running."}],"resultDescription":"Returns aggregated data for the requested perp symbol: number of smart-money wallets long vs short (out of a 200-wallet cohort), their total long, short, and net USD exposure, 24-hour change in exposure, concentration metrics (largest wallet's share of cohort exposure, trader count), average leverage settings, the cohort's share of total open interest, and crowd comparison signals (current funding rate, 7-day price move). May flag when smart money is broadly positioned against a crowded directional move. No individual wallet addresses are returned.","failureModes":["Unknown or unsupported coin symbol returns an error or empty result","Network timeout if Hyperliquid data feed is unavailable","Stale data if the underlying on-chain data pipeline is lagging","Payment failure (x402) if USDC balance is insufficient for the $0.01 call cost","Coin symbol case sensitivity issues (e.g. 'btc' vs 'BTC')"],"whenToPreferThis":"Use this endpoint when you need to understand how a curated cohort of Hyperliquid's most profitable traders are positioned in a specific perpetual before executing a trade or forming a directional view. Prefer this over generic open-interest or funding-rate feeds when you want smart-money-specific positioning context, concentration risk signals, and crowd-vs-smart-money divergence — all aggregated and signed, without exposing individual wallets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:30:06.106Z","isFirstParty":false,"canonicalSlug":"annalist-smart-money-perp-positioning-a1481294"}