Current vs predicted funding rate per HL perp — spot divergences before they print.

Reads the `funding_rate.predicted_next` column that the HL adapter hydrates on every heartbeat. Sort by the absolute delta between current and predicted to find markets that are about to flip from positive to negative funding (or vice versa).

Query parameters

All query parameters are optional unless marked required.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{
  rates: Array<{
    instrumentId: number;
    canonicalSymbol: string;
    base: string;
    quote: string;
    currentRate: number | null;
    predictedRate: number | null;
    deltaRate: number | null;
    intervalHours: number | null;
    ts: number;
  }>;
}

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

curl -sS "http://localhost:3000/api/v1/hyperliquid/predicted-funding?limit=10"

{ "data": { "rates": [] }, "meta": { "total": 0, "limit": 10, "sort": "abs" } }

Notes

• Empty when the `funding_rate.predicted_next` column has not yet been populated — not an error.