{"uid":"cap_InAdzVq1hyP7C0te1MwsZ","slug":"hyperliquid-top-position-snapshot-x402-69c2120d","name":"Hyperliquid Top Position Snapshot (x402)","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/v1/coinank/hyper/top-position?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","properties":{"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Rows per ranking (default 10)"},"min_volume_usd":{"type":"number","minimum":0,"description":"Liquidity filter on 24h notional volume (default 1000000)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"venue":"hyperliquid","liquid":140,"breadth":{"label":"broad_rally","advancers":96,"decliners":44,"advance_ratio":0.686},"sources":["https://api.hyperliquid.xyz/info"],"universe":230,"top_losers":[],"top_volume":[],"updated_at":"2026-10-29T16:00:00Z","top_gainers":[{"coin":"HYPE","mark_px":41.2,"premium_bps":-1.1,"max_leverage":10,"vol_oi_ratio":0.34,"change_24h_pct":8.4,"volume_24h_usd":410000000,"funding_apr_pct":14.2,"open_interest_usd":1200000000}],"highest_funding":[],"unusual_activity":[],"top_open_interest":[],"most_negative_funding":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CdlT5dZFt_YdlCVCnagKr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked market-breadth snapshot from Hyperliquid: top gainers/losers, highest/most-negative funding, top open interest and volume, advance/decline ratio, and unusual activity — filtered by liquidity and row count.","exampleAgentPrompt":"Give me a Hyperliquid market snapshot — show the top 15 coins filtered to at least $5M in 24h volume, including top gainers, highest funding rates, and the overall advance/decline breadth.","exampleUseCases":[{"title":"Pre-trade market breadth check","prompt":"Before I open any positions, pull a Hyperliquid breadth snapshot — top 10 gainers and decliners, plus whether the market is in a broad rally or selloff, filtered to coins with at least $2M in daily volume."},{"title":"Funding rate arbitrage scan","prompt":"Show me which Hyperliquid perps have the highest and most negative funding rates right now, with at least $1M in 24h volume — I want to spot funding arb opportunities."},{"title":"High open-interest momentum screen","prompt":"Give me the top 10 Hyperliquid coins by open interest and by 24h volume — I'm looking for the most liquid names with momentum to trade today."}],"resultDescription":"A JSON object containing: venue name, total universe count, liquid coin count, breadth stats (advancers, decliners, advance_ratio, label), ranked lists for top gainers/losers/volume/open interest/highest funding/most negative funding/unusual activity, each entry with mark price, 24h change %, funding APR %, open interest USD, 24h volume USD, vol/OI ratio, premium bps, max leverage, and a data freshness timestamp.","failureModes":["Invalid limit value (outside 1–25) returns a 400 validation error","min_volume_usd below 0 returns a 400 validation error","Payment not included or insufficient USDC triggers a 402 Payment Required response","Hyperliquid upstream API outage may cause stale or missing data","Workers deployment downtime returns 5xx"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a structured, ranked Hyperliquid-specific market overview — covering breadth, momentum, funding, and open interest in one call — rather than querying a single coin's data or a multi-venue aggregator. It is especially useful for screening or pre-trade routines where the agent needs to identify which perps are moving and why, without holding any API keys (payment is handled via x402/USDC on Base).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:42:14.951Z","isFirstParty":false,"canonicalSlug":"hyperliquid-top-position-snapshot-x402-69c2120d"}