Perp Funding
Return one current Hyperliquid native perpetual snapshot with hourly funding, 8-hour equivalent, simple nominal annualization of the current hourly rate, mark/oracle basis, Hyperliquid funding premium index, open interest, daily notional volume and max leverage. Forest reads only the fixed public Hyperliquid info endpoint; the annualized field is not compounded, forecast or realized return, and Forest does not trade, sign, read a wallet or recommend a position.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- get the current BTC perpetual funding rate
- check current ETH perp funding and mark versus oracle basis
- is Hyperliquid funding positive or negative for this coin
- get current crypto perpetual open interest and funding context
- check the current carry cost and premium context for a perpetual
What Forest guarantees
- fixed public Hyperliquid /info source and native/core perpetual universe only; caller cannot choose another venue or URL
- one market-wide metaAndAssetCtxs POST on a cold refresh, shared single-flight cache for 3000 ms, and no per-coin upstream fan-out
- process-local provider pacing of at least 2000 ms between refreshes with at most 16 queued refresh slots before fail-fast busy
- exact normalized coin selection with aligned bounded universe/context arrays and strict finite numeric parsing
- 8-hour funding equivalent is hourly funding multiplied by 8; funding_apr_percent is a simple nominal annualization calculated as hourly funding multiplied by 24×365×100, not compounded, forecast or realized return
- mark/oracle basis is derived from mark_price / oracle_price - 1; Hyperliquid premium index is reported separately and is not mislabeled as mark/oracle basis
- open_interest_usd_derived is explicitly derived as open-interest units multiplied by mark price
Boundaries
- historical funding, predicted funding, cross-exchange normalization, order books, liquidations or HIP-3 builder-deployed dex markets
- trade direction, expected profit, arbitrage opportunity, leverage recommendation or investment advice
- order placement/cancel, signing, wallet/account positions, credentials or any exchange mutation
- global cross-replica rate limiting; cache, single-flight and provider pacing are process-local
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
Canonical paid endpoint
Related capabilities
- Perp Funding-history — Return a bounded recent history of realized hourly funding-rate observations for one exact Hyperliquid native perpetual. Forest makes one fixed public fundingHistory request, returns at most 168 newest normalized observations, and reuses the existing shared Hyperliquid pacing boundary. This is historical market data only, not a prediction, arbitrage signal, trader funding ledger or trading recommendation.
- Crypto Fear-greed — Return the current Bitcoin-focused Crypto Fear & Greed reading and an optional bounded recent daily history from Alternative.me. Forest preserves the provider classification and prominent source attribution; it does not synthesize an asset-specific altcoin score, forecast price, create a trading signal, recommend a trade or access any account or wallet.
- Crypto Spot-price — Return one current Coinbase spot-product snapshot for an exact BASE-QUOTE product id, including venue price, 24-hour price change and provider-reported 24-hour product volume. Forest reads only Coinbase Advanced Trade public market data; it does not infer tickers, infer the provider volume denomination, aggregate venues, read an account or wallet, place orders, provide an executable quote, forecast returns or recommend a trade.
- Sec Company-resolve — Resolve one exact U.S. public-company ticker to the SEC canonical CIK and EDGAR-conformed company name using the official SEC company_tickers.json mapping. Forest performs no fuzzy company-name search, filing download, market-data inference or mutation.
- Sec Recent-filings — Return newest-first metadata for recent official SEC EDGAR submissions for one exact ticker or CIK, optionally filtered to an exact form such as 10-K, 10-Q, 8-K or S-1. Forest returns bounded filing metadata and canonical SEC archive links only; it does not download filing bodies, crawl exhibits, parse XBRL or perform investment analysis.
- Treasury Yield-curve — Return the latest published U.S. Treasury Daily Treasury Par Yield Curve Rates snapshot across standard maturities from 1 month through 30 years. Forest normalizes one coherent official daily observation, reports missing Treasury tenors as null, and performs no forecast, interpolation, trading signal or secondary-market inference.