← 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.

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.

$0.002 / callPOST /perp/funding-historyx402 · Base

Typical agent tasks

This capability is intended for bounded machine decisions such as:

What Forest guarantees

Boundaries

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

{ "coin": "BTC", "limit": 24 }

Canonical paid endpoint

https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/perp/funding-history

OpenAPI contract →

Related capabilities