Real-time and historical Hyperliquid funding rates for 229 perp markets. Sort by highest/lowest, find arb opportunities. Zero-cost data.
Three tools with strong descriptions (194 - 250 chars, well above baseline 194 avg) and clear use-case guidance. All have proper JSON Schema with typed parameters and enums. However, output schemas are documented only in description text, not as formal response schemas in the tool definition. Parameters lack explicit min/max constraints for numeric fields (e.g., hours: 1 - 720). No error handling guidance or recovery paths documented. Tool names follow verb_noun pattern correctly. Descriptions include helpful 'Do NOT use for...' anti-patterns, which is excellent for disambiguation.
Use this when you need to find funding rate arbitrage opportunities on Hyperliquid. Scans all 229 perp markets and returns coins where the absolute funding rate exceeds 0.01% per 8h period (annualized > 36%), flagged as long or short opportunities based on rate direction. Data returned for each opportunity: 1. coin: ticker symbol with extreme funding 2. fundingRate: current 8-hour rate as decimal 3. annualizedRate: annualized percentage (rate * 3 * 365) 4. direction: "long opportunity" (negative rate = longs get paid) or "short opportunity" (positive rate = shorts get paid) 5. openInterest: total OI in USD (liquidity indicator) 6. markPrice: current mark price in USD 7. premium: mark-oracle price premium Example output: { threshold: 0.0001, totalOpportunities: 12, longOpportunities: 5, shortOpportunities: 7, opportunities: [{ coin: "PEPE", fundingRate: 0.0005, annualizedRate: 54.75, direction: "short opportunity", openInterest: 85000000, markPrice: 0.0000125, premium: 0.001 }, ...] } Use this to identify carry trade setups where you earn funding by taking the opposite side of a crowded trade. Combine with spot hedging for delta-neutral strategies. Do NOT use for historical funding trends -- use hyperliquid_get_funding_history instead. Do NOT use for DEX swap quotes -- use dex_get_swap_quote instead. Do NOT use for DeFi yield farming -- use defi_find_best_yields instead.
Use this when you need historical funding rate data for a specific Hyperliquid perpetual market. Returns timestamped funding rate entries over a configurable lookback window, plus summary statistics including average, min, max, and standard deviation. Data returned: 1. coin: the queried ticker symbol (e.g. BTC, ETH, SOL) 2. hours: lookback period requested (default 24) 3. entries: array of { time (ISO 8601), fundingRate (decimal), annualizedRate (%) } 4. summary.count: number of funding periods in the window 5. summary.avgRate: average funding rate over the period 6. summary.avgAnnualized: average annualized rate (%) 7. summary.minRate / maxRate: extremes observed in the window 8. summary.stdDev: standard deviation of rates (volatility of funding) Example output: { coin: "ETH", hours: 24, entries: [{ time: "2026-04-13T08:00:00Z", fundingRate: 0.0001, annualizedRate: 10.95 }, ...], summary: { count: 3, avgRate: 0.00012, avgAnnualized: 13.14, minRate: 0.00008, maxRate: 0.00015, stdDev: 0.000029 } } Use this to analyze funding trends before entering a carry trade or to backtest funding-based strategies over recent periods. Do NOT use for current rates across all markets -- use hyperliquid_get_funding_rates instead. Do NOT use for on-chain wallet analysis -- use wallet_get_portfolio instead. Do NOT use for CEX funding rates -- use funding_rates_get_current instead.
Output schemas not formally documented in tool definitions. Descriptions include example JSON, but no structured response schema (e.g., JSON Schema for return type) is visible in the tool registration.
Numeric parameter 'hours' in hyperliquid_get_funding_history lacks explicit min/max constraints. Description states 'Max: 720' but JSON Schema has no minimum/maximum fields.
No error handling guidance. Tools do not document what happens on invalid coin symbols, network failures, or out-of-range parameters. LLM has no recovery path.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | 2025-06-18+ | v2 |
Use this when you need current funding rates across all Hyperliquid perpetual markets. Returns real-time funding rate, premium, open interest, and mark price for every listed perp coin on Hyperliquid DEX, sorted by your chosen criteria. Data returned for each market: 1. coin: ticker symbol (e.g. BTC, ETH, SOL, DOGE) 2. fundingRate: current 8-hour funding rate as a decimal (e.g. 0.0001 = 0.01%) 3. annualizedRate: funding rate annualized (rate * 3 * 365) as a percentage 4. premium: mark-oracle price premium as a decimal 5. openInterest: total open interest in USD 6. markPrice: current mark price in USD Example output: { totalMarkets: 229, sort: "abs", rates: [{ coin: "BTC", fundingRate: 0.000125, annualizedRate: 13.69, premium: 0.0002, openInterest: 1250000000, markPrice: 68500.5 }, ...] } Use this BEFORE opening perp positions to check funding cost. Essential for carry trade analysis, market sentiment gauging, and identifying crowded trades. Do NOT use for historical funding data -- use hyperliquid_get_funding_history instead. Do NOT use for vault performance data -- use hyperliquid_get_vault_details instead. Do NOT use for whale position tracking -- use hyperliquid_track_whale_positions instead.
Parameter 'threshold' in hyperliquid_find_funding_arb has no explicit min/max. Description states 'Default: 0.0001' but no bounds prevent LLM from passing negative or absurdly large values.
Tool descriptions include example output JSON inline, which risks LLM reusing example values literally (e.g., 'BTC' as the only valid coin). Formal enum or pattern constraints would be safer.