{"openapi":"3.1.0","info":{"title":"Annalist","version":"0.1.0","description":"Paid routes require an x402 payment (USDC). Historical statistics and current market data. Not investment advice."},"servers":[{"url":"https://api.annalist.dev"}],"paths":{"/v1/crowd/perp":{"get":{"summary":"Use before acting on a Hyperliquid perpetual to see whether it is crowded or in a hype state and what historically followed","description":"Use before acting on a Hyperliquid perpetual to see whether it is crowded or in a hype state and what historically followed. Returns 7-day move, funding (hourly, APR, percentile vs its own 90 days and vs all perps), open interest and its 24h/7d change, premium, Wikipedia attention, active crowd states, and each state's base rates (sample size, median and spread of 7/30/90-day returns). Signed. Not investment advice.","x-price":"$0.01","parameters":[{"name":"coin","in":"query","required":true,"schema":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}}],"responses":{"200":{"description":"Signed data"},"402":{"description":"Payment required (x402)"}}}},"/v1/crowd/states":{"get":{"summary":"Every Hyperliquid perp currently in a crowd state (7-day moves of +50/+100/+200%, funding in its own top or bottom 5%, Wikipedia attention spikes, new listings), ranked by 7-day move, each with base rates for what followed similar states historically","description":"Every Hyperliquid perp currently in a crowd state (7-day moves of +50/+100/+200%, funding in its own top or bottom 5%, Wikipedia attention spikes, new listings), ranked by 7-day move, each with base rates for what followed similar states historically. Optional ?state= filter. Signed. Not investment advice.","x-price":"$0.02","parameters":[{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["up_50pct_7d","up_100pct_7d","up_200pct_7d","funding_top5","funding_bottom5","attention_spike_3x","new_listing"]}}],"responses":{"200":{"description":"Signed data"},"402":{"description":"Payment required (x402)"}}}},"/v1/crowd/market":{"get":{"summary":"Market-wide crowding on Hyperliquid: breadth of 7-day moves, how many perps are up 50%+/100%+ in a week, share of perps with funding in their own top/bottom 5%, total open interest and its 24h change, BTC and ETH funding percentiles, and Wikipedia attention to cryptocurrency","description":"Market-wide crowding on Hyperliquid: breadth of 7-day moves, how many perps are up 50%+/100%+ in a week, share of perps with funding in their own top/bottom 5%, total open interest and its 24h change, BTC and ETH funding percentiles, and Wikipedia attention to cryptocurrency. Signed. Not investment advice.","x-price":"$0.01","parameters":[],"responses":{"200":{"description":"Signed data"},"402":{"description":"Payment required (x402)"}}}},"/v1/crowd/changes":{"get":{"summary":"For bots that poll: crowd-state events (a perp entering or leaving a state) since a timestamp, newest first, up to 7 days back","description":"For bots that poll: crowd-state events (a perp entering or leaving a state) since a timestamp, newest first, up to 7 days back. Each event is signed with the mark price at the time. Not investment advice.","x-price":"$0.005","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Signed data"},"402":{"description":"Payment required (x402)"}}}},"/v1/crowd/history":{"get":{"summary":"Signed historical crowd-state events for backtesting: up to 30 days per call, optionally filtered by coin and state","description":"Signed historical crowd-state events for backtesting: up to 30 days per call, optionally filtered by coin and state. The archive is append-only and its daily hashes are published and Bitcoin-timestamped.","x-price":"$0.05","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"coin","in":"query","required":false,"schema":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["up_50pct_7d","up_100pct_7d","up_200pct_7d","funding_top5","funding_bottom5","attention_spike_3x","new_listing"]}}],"responses":{"200":{"description":"Signed data"},"402":{"description":"Payment required (x402)"}}}},"/v1/smart/perp":{"get":{"summary":"Use before acting on a Hyperliquid perpetual to see how the most profitable Hyperliquid traders are positioned in it: how many wallets in a 200-wallet smart-money cohort are long vs short, their long, short and net exposure in USD, the 24h change, how concentrated it is (largest wallet's share, trader-count view), leverage settings, their share of open interest, and how that compares with the crowd (funding, 7-day move)","description":"Use before acting on a Hyperliquid perpetual to see how the most profitable Hyperliquid traders are positioned in it: how many wallets in a 200-wallet smart-money cohort are long vs short, their long, short and net exposure in USD, the 24h change, how concentrated it is (largest wallet's share, trader-count view), leverage settings, their share of open interest, and how that compares with the crowd (funding, 7-day move). Flags smart money broadly positioned against a crowded move. Aggregates only, never wallet addresses. Signed. Not investment advice.","x-price":"$0.01","parameters":[{"name":"coin","in":"query","required":true,"schema":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}}],"responses":{"200":{"description":"Signed data"},"402":{"description":"Payment required (x402)"}}}},"/v1/smart/market":{"get":{"summary":"Where Hyperliquid's most profitable traders are positioned across all perps: the cohort's overall net long or short, the coins it is most net long and most net short, the biggest 24-hour changes, and coins where smart money is positioned against the crowd","description":"Where Hyperliquid's most profitable traders are positioned across all perps: the cohort's overall net long or short, the coins it is most net long and most net short, the biggest 24-hour changes, and coins where smart money is positioned against the crowd. Cohort definition included. Aggregates only. Signed. Not investment advice.","x-price":"$0.02","parameters":[],"responses":{"200":{"description":"Signed data"},"402":{"description":"Payment required (x402)"}}}}}}