{"service":"Annalist","url":"https://annalist.dev","summary":"Signed data for agents, mined from public data and sold per call. Hyperliquid: crowd state with what usually followed, smart money, liquidation levels, stock and commodity perps, prediction markets and the HLP vault. The agent economy: independent checks of x402 services and MCP servers, price benchmarks and listing changes.","how_to_pay":{"protocol":"x402 v2","network":"eip155:8453","asset":"USDC","pay_to":"0xDE4805678438b6bfBbFE047fFF305C928653Fe17","mcp":"https://api.annalist.dev/mcp","docs":"https://api.annalist.dev/llms.txt","openapi":"https://api.annalist.dev/openapi.json"},"skill":"https://github.com/ryanroskowski/annalist-skills","products":[{"question":"Is this Hyperliquid perp crowded or in a hype state, and what usually happened next?","method":"GET","path":"/v1/crowd/perp","price":"$0.01","mcp_tool":"crowd_perp","example":"https://api.annalist.dev/v1/crowd/perp?coin=SOL","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.","input_schema":{"type":"object","properties":{"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}},"required":["coin"]},"tags":["crypto","hyperliquid","funding","crowd","base-rates"]},{"question":"Which Hyperliquid perps are crowded right now?","method":"GET","path":"/v1/crowd/states","price":"$0.02","mcp_tool":"crowd_states","example":"https://api.annalist.dev/v1/crowd/states?state=up_100pct_7d","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.","input_schema":{"type":"object","properties":{"state":{"type":"string","enum":["up_50pct_7d","up_100pct_7d","up_200pct_7d","funding_top5","funding_bottom5","attention_spike_3x","new_listing"]}}},"tags":["crypto","hyperliquid","funding","crowd","base-rates"]},{"question":"How crowded is the Hyperliquid market overall?","method":"GET","path":"/v1/crowd/market","price":"$0.01","mcp_tool":"crowd_market","example":"https://api.annalist.dev/v1/crowd/market","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.","input_schema":{"type":"object","properties":{}},"tags":["crypto","hyperliquid","funding","crowd","base-rates"]},{"question":"Which perps entered or left a crowd state since a given time?","method":"GET","path":"/v1/crowd/changes","price":"$0.005","mcp_tool":"crowd_changes","example":"https://api.annalist.dev/v1/crowd/changes?since=2026-10-12T00%3A00%3A00Z","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.","input_schema":{"type":"object","properties":{"since":{"type":"string","format":"date-time"}},"required":["since"]},"tags":["crypto","hyperliquid","funding","crowd","base-rates"]},{"question":"Which crowd-state events happened between two dates (for backtesting)?","method":"GET","path":"/v1/crowd/history","price":"$0.05","mcp_tool":"crowd_history","example":"https://api.annalist.dev/v1/crowd/history?from=2026-10-01&to=2026-10-12&coin=SOL","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.","input_schema":{"type":"object","required":["from","to"],"properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"},"state":{"type":"string","enum":["up_50pct_7d","up_100pct_7d","up_200pct_7d","funding_top5","funding_bottom5","attention_spike_3x","new_listing"]}}},"tags":["crypto","hyperliquid","funding","crowd","base-rates"]},{"question":"How are Hyperliquid's most profitable traders positioned in this perp?","method":"GET","path":"/v1/smart/perp","price":"$0.01","mcp_tool":"smart_perp","example":"https://api.annalist.dev/v1/smart/perp?coin=SOL","description":"Use before acting on a Hyperliquid perpetual to see how its most profitable traders are positioned: how many wallets in a 200-wallet smart-money cohort are long vs short, long, short and net USD, the 24h change, concentration, leverage settings, share of open interest, and how that compares with the crowd (funding, 7-day move). Flags smart money positioned against a crowded move. Aggregates only, never wallet addresses. Signed. Not investment advice.","input_schema":{"type":"object","properties":{"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}},"required":["coin"]},"tags":["crypto","hyperliquid","funding","crowd","base-rates"]},{"question":"Where is Hyperliquid's smart money positioned across all perps?","method":"GET","path":"/v1/smart/market","price":"$0.02","mcp_tool":"smart_market","example":"https://api.annalist.dev/v1/smart/market","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.","input_schema":{"type":"object","properties":{}},"tags":["crypto","hyperliquid","funding","crowd","base-rates"]},{"question":"Where would liquidations hit for this perp, and can the order book absorb them?","method":"GET","path":"/v1/liq/perp","price":"$0.02","mcp_tool":"liq_perp","example":"https://api.annalist.dev/v1/liq/perp?coin=BTC","description":"Use before opening, sizing or holding a Hyperliquid perpetual position to see where forced selling or buying would hit: known longs liquidating within 1 to 20% below the mark and shorts above it, the biggest clusters, and coverage of open interest, set against order-book depth, spread and slippage as cascade ratios. Flags long_cascade_risk, short_squeeze_risk, thin_book. From large accounts' public positions. Aggregates only. Signed. Not investment advice.","input_schema":{"type":"object","properties":{"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}},"required":["coin"]},"tags":["crypto","hyperliquid","liquidations","order-book","risk"]},{"question":"Which Hyperliquid perps have the most liquidations close to the price?","method":"GET","path":"/v1/liq/market","price":"$0.03","mcp_tool":"liq_market","example":"https://api.annalist.dev/v1/liq/market","description":"Liquidation pressure across Hyperliquid's largest perps: for each, the known longs liquidating within 5% below the mark and shorts within 5% above it, cascade ratios against order-book depth, 2% depth, how much of open interest the known positions cover, and flags; plus the coins with the most liquidations nearby. Aggregates only. Signed. Not investment advice.","input_schema":{"type":"object","properties":{}},"tags":["crypto","hyperliquid","liquidations","order-book","risk"]},{"question":"What is happening in this stock, index, commodity or FX perp on Hyperliquid?","method":"GET","path":"/v1/hip3/perp","price":"$0.01","mcp_tool":"hip3_perp","example":"https://api.annalist.dev/v1/hip3/perp?coin=xyz%3ANVDA","description":"Use before trading a stock, index, commodity or FX perpetual on Hyperliquid (builder-deployed, HIP-3; coins like xyz:NVDA, xyz:GOLD, xyz:SP500): price and 1h, 24h, 7d and 30d moves, volume, open interest and its 24h change, how close it is to its open-interest cap, funding (hourly, APR, percentile vs its own 30 days), premium and max leverage, with flags. Signed. Not investment advice.","input_schema":{"type":"object","properties":{"coin":{"type":"string","description":"exchange:asset, for example xyz:NVDA, xyz:GOLD, xyz:SP500 (case-sensitive)"}},"required":["coin"]},"tags":["hyperliquid","stocks","commodities","perpetuals","funding"]},{"question":"What is moving across Hyperliquid's stock, commodity and FX perps?","method":"GET","path":"/v1/hip3/market","price":"$0.02","mcp_tool":"hip3_market","example":"https://api.annalist.dev/v1/hip3/market","description":"Overview of every builder-deployed (HIP-3) perpetual on Hyperliquid, mostly 24/7 stock, index, commodity and FX markets: each exchange's markets, open interest and volume; the largest and most traded markets; the biggest 24h moves; funding extremes; markets near their open-interest cap; and flags. Signed. Not investment advice.","input_schema":{"type":"object","properties":{}},"tags":["hyperliquid","stocks","commodities","perpetuals","funding"]},{"question":"What are the live prediction-market odds on Hyperliquid (sports, prices, IPOs, Fed decisions, awards)?","method":"GET","path":"/v1/outcomes/list","price":"$0.02","mcp_tool":"outcomes_list","example":"https://api.annalist.dev/v1/outcomes/list?category=sports","description":"Every live Hyperliquid outcome (prediction) market: readable title, category (sports, price, ipo, policy_rate, awards), deadline, each side's price as implied probability with its 24h change, and 24h volume, most traded first. Filter with category and q (text search). On-chain data. Signed. Not investment advice.","input_schema":{"type":"object","properties":{"category":{"type":"string","enum":["sports","price","ipo","policy_rate","awards","other"]},"q":{"type":"string","description":"text to find in titles, for example Fed or Anthropic"}}},"tags":["prediction-markets","odds","sports","events","hyperliquid"]},{"question":"What are the odds for this prediction market, and how have they moved this week?","method":"GET","path":"/v1/outcomes/market","price":"$0.01","mcp_tool":"outcomes_market","example":"https://api.annalist.dev/v1/outcomes/market?id=8573","description":"One Hyperliquid outcome (prediction) market by id: readable title, structured details (teams, thresholds, deadlines, official source), each side's implied probability, 24h change, volume and outstanding value, its question, and a week of hourly prices per side. Ids come from /v1/outcomes/list. Signed. Not investment advice.","input_schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9]+$","description":"outcome id"}},"required":["id"]},"tags":["prediction-markets","odds","sports","events","hyperliquid"]},{"question":"Where is Hyperliquid's own market-making vault (HLP) exposed, and how is it doing?","method":"GET","path":"/v1/vaults/hlp","price":"$0.01","mcp_tool":"hlp_vault","example":"https://api.annalist.dev/v1/vaults/hlp","description":"Hyperliquid's own market-making vault (HLP), which takes over liquidated positions: account value, APR, PnL over a day, week, month and all time, and its net position per coin across all its sub-vaults, with the most long, most short and biggest 24h changes. Shows where the exchange itself is exposed. Signed. Not investment advice.","input_schema":{"type":"object","properties":{}},"tags":["crypto","hyperliquid","vaults","market-making","positions"]},{"question":"Everything on one Hyperliquid perp in one call: is it crowded, how is smart money positioned, and where are the liquidations?","method":"GET","path":"/v1/perp/full","price":"$0.03","mcp_tool":"perp_full","example":"https://api.annalist.dev/v1/perp/full?coin=BTC","description":"One call, one payment for everything on a Hyperliquid perpetual: crowd state with base rates for what usually followed (as /v1/crowd/perp), smart-money positioning (as /v1/smart/perp) and liquidation levels with order-book depth (as /v1/liq/perp), each with its own as_of. Cheaper than buying the three separately. Signed. Not investment advice.","input_schema":{"type":"object","properties":{"coin":{"type":"string","description":"Hyperliquid perp symbol, for example BTC, ETH, SOL, HYPE, kPEPE"}},"required":["coin"]},"tags":["crypto","hyperliquid","perpetuals","smart-money","liquidations"]},{"question":"Is this x402 service real and reliable, and does it charge what it lists?","method":"GET","path":"/v1/checks/service","price":"$0.01","mcp_tool":"checks_service","example":"https://api.annalist.dev/v1/checks/service?host=api.annalist.dev","description":"Use before paying an x402 service: independent checks by host or URL. Uptime and latency from repeated unpaid probes, whether the quoted price and payout wallet match the listing, real on-chain usage over 30 days with fake volume removed (self-funded payers, crawler bots, one-wallet dominance), test purchases and domain age, with a grade and reasons. Rankings are never for sale. Signed.","input_schema":{"type":"object","properties":{"host":{"type":"string","description":"host name, for example api.example.com"},"url":{"type":"string","description":"or any URL on the service"}}},"tags":["x402","trust","verification","agent-economy","ratings"]},{"question":"Is the revenue behind this x402 payout wallet real, and which services use it?","method":"GET","path":"/v1/checks/seller","price":"$0.01","mcp_tool":"checks_seller","example":"https://api.annalist.dev/v1/checks/seller?address=0xDE4805678438b6bfBbFE047fFF305C928653Fe17","description":"Checks for an x402 seller wallet on Base: the services that pay out to it and their grades, and USDC received over 30 days with payers, repeat payers and fake-volume signals (payers the seller funded, crawler bots, one-wallet dominance). Signed.","input_schema":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}},"required":["address"]},"tags":["x402","trust","verification","agent-economy","ratings"]},{"question":"Which x402 services have the most real customers and the best reliability, and which are flagged?","method":"GET","path":"/v1/checks/top","price":"$0.02","mcp_tool":"checks_top","example":"https://api.annalist.dev/v1/checks/top","description":"Leaderboards from our independent checks of x402 services: most real (wash-adjusted) paying customers, most reliable, and flagged services (price or wallet mismatches, outages, mostly bot traffic, self-funded volume), with the method. Rankings are never for sale. Signed.","input_schema":{"type":"object","properties":{}},"tags":["x402","trust","verification","agent-economy","ratings"]},{"question":"What changed in x402 listings: which services changed prices, endpoints or payout wallets?","method":"GET","path":"/v1/checks/changes","price":"$0.01","mcp_tool":"checks_changes","example":"https://api.annalist.dev/v1/checks/changes?days=1","description":"What changed in x402 service listings, from daily snapshots of Coinbase's Bazaar: price raises and cuts, endpoints added and dropped, new and departed services, and payout-wallet changes (worth checking before paying: a hijacked listing looks the same as a rotated wallet). Market-wide for the last 1 to 7 days, or one service's 30-day change log with host=. Signed.","input_schema":{"type":"object","properties":{"host":{"type":"string","description":"optional: one service by host name or URL"},"days":{"type":"string","description":"how many days back: 1 to 7 market-wide, up to 30 for one service (default 7)"}}},"tags":["x402","trust","pricing","agent-economy","changes"]},{"question":"Is this MCP server up and fast, does it need sign-in, and did its tools change?","method":"GET","path":"/v1/mcp/server","price":"$0.01","mcp_tool":"mcp_server","example":"https://api.annalist.dev/v1/mcp/server?name=io.github.ryanroskowski%2Fannalist","description":"Use before connecting a remote MCP server: independent checks by registry name or URL. Uptime and connect time from daily probes (initialize and tools/list; no tool is ever called), sign-in mode, protocol version, tool count, and tool-definition changes in 30 days (how 'rug pull' attacks work), with domain age, a grade and reasons. Covers remote servers in the Official MCP Registry. Signed.","input_schema":{"type":"object","properties":{"name":{"type":"string","description":"registry name, for example io.github.user/server"},"url":{"type":"string","description":"or the server's URL or host"}}},"tags":["mcp","trust","reliability","agent-economy","ratings"]},{"question":"Which remote MCP servers are most reliable, which changed their tools this week, and which are flagged?","method":"GET","path":"/v1/mcp/top","price":"$0.02","mcp_tool":"mcp_top","example":"https://api.annalist.dev/v1/mcp/top","description":"Leaderboards from our independent checks of remote MCP servers in the Official MCP Registry: most reliable (up in 99%+ of probes, fastest first), servers whose tool definitions changed in the last 7 days, flagged servers (often down, new domains), and counts by sign-in mode, with the method. Rankings are never for sale. Signed.","input_schema":{"type":"object","properties":{}},"tags":["mcp","trust","reliability","agent-economy","ratings"]},{"question":"Should my agent depend on this npm, PyPI, Rust or Go package, and did it just change hands?","method":"GET","path":"/v1/packages/check","price":"$0.01","mcp_tool":"packages_check","example":"https://api.annalist.dev/v1/packages/check?ecosystem=npm&name=lodash","description":"Supply-chain check of a popular package (the 8,000 most used on each of npm, PyPI, crates.io and Go): latest version and release activity, maintainers or owners, install scripts, provenance, deprecation, retractions, and what changed since we began tracking it daily: releases by a new publisher account, owner changes, install scripts added, provenance dropped, source repository moved, yanks. Account names are never published. Signed.","input_schema":{"type":"object","properties":{"ecosystem":{"type":"string","enum":["npm","pypi","crates","go"],"description":"npm (default), pypi, crates or go"},"name":{"type":"string","description":"package name, for example lodash, requests, serde or golang.org/x/crypto"}},"required":["name"]},"tags":["supply-chain","security","npm","pypi","rust"]},{"question":"Which popular npm, PyPI, Rust or Go packages changed hands or added risky behaviour recently?","method":"GET","path":"/v1/packages/watch","price":"$0.02","mcp_tool":"packages_watch","example":"https://api.annalist.dev/v1/packages/watch?days=7","description":"Supply-chain watch across the 8,000 most-used packages on each of npm, PyPI, crates.io and Go, newest first: releases by a new publisher account, maintainer and owner changes, install scripts added, provenance dropped, source repositories moved, retractions, deprecations and yanks, with counts, for the last 1 to 30 days (days=, default 7), for one ecosystem or all. Signed.","input_schema":{"type":"object","properties":{"ecosystem":{"type":"string","enum":["npm","pypi","crates","go"]},"days":{"type":"string","description":"1 to 30 (default 7)"}}},"tags":["supply-chain","security","npm","pypi","rust"]},{"question":"What does this AI model cost per million tokens, on which providers, and which models fit my budget?","method":"GET","path":"/v1/ai/prices","price":"$0.01","mcp_tool":"ai_prices","example":"https://api.annalist.dev/v1/ai/prices?model=claude-sonnet-4-5","description":"AI model prices per million tokens (input, output, cache, batch) with context window, for about 4,000 models across providers. With model=: its price history and the same model on other providers. Without: a list filtered by provider, mode, min_context and max_input price, sorted by input, output or context. History from January 2026. Source: LiteLLM's open price file (MIT). Signed.","input_schema":{"type":"object","properties":{"model":{"type":"string"},"provider":{"type":"string"},"mode":{"type":"string","description":"chat, embedding, image_generation..."},"min_context":{"type":"string"},"max_input":{"type":"string","description":"max input price, USD per million tokens"},"sort":{"type":"string","enum":["input","output","context"]},"limit":{"type":"string"}}},"tags":["ai","llm","pricing","models","price-history"]},{"question":"Which AI model prices changed recently, and which models were added or retired?","method":"GET","path":"/v1/ai/changes","price":"$0.01","mcp_tool":"ai_changes","example":"https://api.annalist.dev/v1/ai/changes?days=30","description":"Recent changes to AI model prices and availability across providers, newest first: price cuts and raises per field (with the change), models added and removed, context-window changes and deprecation dates, for the last 1 to 90 days, optionally by provider or model name. Source: LiteLLM's open price file (MIT), recorded daily. Signed.","input_schema":{"type":"object","properties":{"days":{"type":"string"},"provider":{"type":"string"},"model":{"type":"string"}}},"tags":["ai","llm","pricing","models","price-history"]},{"question":"How has this x402 service's pricing changed, and is it cheap or expensive for its category?","method":"GET","path":"/v1/prices/service","price":"$0.01","mcp_tool":"prices_service","example":"https://api.annalist.dev/v1/prices/service?host=api.annalist.dev","description":"Price history of an x402 service by host or URL: each listed endpoint's price, first-seen date and changes, price changes in 30 days (raised, lowered, delisted), the prices it actually quoted when we called it, and where it sits against similar services by category (market median and percentile). Signed.","input_schema":{"type":"object","properties":{"host":{"type":"string","description":"host name, for example api.example.com"},"url":{"type":"string","description":"or any URL on the service"}}},"tags":["x402","pricing","benchmarks","agent-economy","price-history"]},{"question":"What do x402 services usually charge for this kind of call, and is this price fair?","method":"GET","path":"/v1/prices/benchmarks","price":"$0.01","mcp_tool":"prices_benchmarks","example":"https://api.annalist.dev/v1/prices/benchmarks?tag=search&price=0.02","description":"Price benchmarks for x402 services by category (seller tags such as search, llm, weather, market-data): how many services, price percentiles (each service counted once, at its median), and 7- and 30-day trends. Add price= to see where a price sits. Without tag: every category. Signed.","input_schema":{"type":"object","properties":{"tag":{"type":"string","description":"category, for example search, llm, weather"},"price":{"type":"string","description":"a price in USDC to place within the category, for example 0.02"}}},"tags":["x402","pricing","benchmarks","agent-economy","price-history"]}],"free":[{"path":"/v1/catalog","what":"this list"},{"path":"/v1/quote","what":"prices and data freshness"},{"path":"/v1/verify/attestation?host=","what":"a service's signed x402 check (grade, facts, reasons), to verify locally before paying it"},{"path":"/v1/verify/badge.svg?host=","what":"the same as a badge sellers can show"},{"path":"/v1/status","what":"collector freshness"},{"path":"/v1/sample","what":"the market view, delayed about 24 hours"},{"path":"/v1/baserates","what":"full base-rate tables: what followed each crowd state"},{"path":"/v1/accuracy","what":"the live track record of each state against its backtest"},{"path":"/v1/report","what":"the Annalist weekly: the agent economy and the markets agents trade this week"}],"trust":{"signature":"Ed25519 over RFC 8785 canonical JSON of {as_of, data, method, request_id}","key":"https://api.annalist.dev/.well-known/annalist-key.json","ledger":"https://github.com/ryanroskowski/annalist-ledger"},"freshness":{"as_of":"2026-10-14T03:21:00Z","stale":false},"notice":"Historical statistics and current market data. Not investment advice."}