Protocol

Bucketed state history: per-market CR, leverage, NAVs, supplies, TVL; USDC peg; earn pool. Each earn-pool field is the last observation of that field within the bucket (pool observations and APY arrive on different cadences); market fields come from the bucket's newest observation. Sparse — absent buckets/markets/fields are omitted, never zero-filled and never carried across buckets. Pre-2026-07-31 buckets carry at most CR/leverage/supplies/collateral price and no usdcPeg. Market virtual-supply counters (+ USDC peg) sum to the real hyUSD supply.

get/v1/protocol/state

Request

Query parameters

granularity'5m' | '1h' | '1d'

Bucket size (last value in bucket). Max window: 7d at 5m, 90d at 1h, 1000d at 1d.

daysinteger

Trailing window ending today (inclusive). Ignored when from is given. Must fit the granularity's window cap.

fromstring date

Inclusive range start (YYYY-MM-DD). Overrides days.

tostring date

Inclusive range end; default today. Range capped at 1000 days; from > to → 400.

Response

Cache-Control: public, max-age=300.

sincestring date required
untilstring date required
granularity'5m' | '1h' | '1d' required

Example response

{
  "since": "2026-08-19",
  "until": "2026-08-19"
}

Changes

    • info

      removed the HYPE enum value from the //// response property for the response status

    • info

      removed the SOL enum value from the //// response property for the response status

    • info

      removed the cbBTC enum value from the //// response property for the response status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status