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.
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:
- retrieve the last 24 hourly BTC funding observations for a carry-cost model
- check whether ETH perpetual funding changed sign during the recent window
- compare recent hourly funding rates before running a basis backtest
- pull bounded Hyperliquid funding history for a market-data dashboard
- inspect the newest realized funding observations for one perpetual market
What Forest guarantees
- one exact Hyperliquid native perpetual coin per request and limit bounded to 1-168 newest observations
- exactly one fixed Hyperliquid public fundingHistory request on a cold cache miss with no pagination or caller-selected provider URL
- shared process-local Hyperliquid pacing and bounded pending queue; identical coin+limit requests use bounded process-local cache and single-flight
- successful provider rows are strictly validated, deduplicated by timestamp and sorted newest-first; malformed or non-finite rows fail closed
- no account, wallet, signing, order placement, position mutation or exchange execution
Boundaries
- predicted future funding, expected profit, arbitrage signal, investment advice or trading recommendation
- a trader account funding ledger, realized PnL or wallet/account history
- cross-exchange funding comparison, backtesting conclusions or provider history beyond the bounded single-request window
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 — 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.
- 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.