# Forest Markets – Hyperliquid Perpetual Funding Snapshot

> Forest Markets – Hyperliquid Perpetual Funding Snapshot is a paid API for AI agents from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Returns a single real-time snapshot of funding and market data for a named Hyperliquid native perpetual, including hourly rate, 8-hour equivalent, simple annualized rate, mark/oracle basis, funding premium index, open interest, daily notional volume, and max leverage.

## Facts

- Endpoint: POST https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/perp/funding?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forest-markets-hyperliquid-perpetual-funding-snapshot-936e31b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KILK4P4iDqt3sEz6D0sXe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forest-markets-hyperliquid-perpetual-funding-snapshot-936e31b9 -d '<json body>'
```

Example prompt: What is the current funding rate, open interest, and annualized rate for the BTC perpetual on Hyperliquid right now?

## When to prefer this

Use this endpoint when you need a real-time, point-in-time funding and market snapshot specifically for a Hyperliquid native perpetual contract — covering hourly/8h/annualized funding rates, mark/oracle basis, open interest, volume, and leverage in a single call. Prefer this over generic crypto data APIs when Hyperliquid-specific data (funding premium index, native perp OI) is required. Not suitable for historical data, realized funding, compounded returns, wallet operations, trade execution, or non-Hyperliquid venues.

## Known failure modes

- Invalid or unrecognized coin ticker returns an error or empty result
- Coin not listed as a Hyperliquid native perpetual returns no data
- Malformed coin string (violating pattern ^[A-Za-z0-9][A-Za-z0-9._-]{0,31}$) returns a validation error
- Hyperliquid public endpoint temporarily unavailable causes upstream fetch failure
- Missing payment header (x402) results in HTTP 402 before data is returned

## How this service works

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. Base mainnet USDC

## Output

A JSON snapshot for the requested coin containing: current hourly funding rate, 8-hour equivalent rate, simple nominally annualized funding rate (not compounded or forecasted), mark price, oracle price, mark/oracle basis, Hyperliquid funding premium index, open interest (in USDC), daily notional volume, and maximum available leverage. Data is sourced live from the public Hyperliquid info endpoint and reflects mainnet USDC-settled perpetuals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,31}$",
   "maxLength": 32,
   "minLength": 1,
   "description": "Public coin value used to scope this lookup."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forest-markets-hyperliquid-perpetual-funding-snapshot-936e31b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run](https://www.zero.xyz/host/http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/llms.txt)