---
title: "State history"
method: GET
path: "/v1/protocol/state"
tags: ["Protocol"]
---

# State history

`GET /v1/protocol/state`

Bucketed state history: per-market CR, leverage, NAVs, supplies, TVL; USDC peg; earn pool. Sparse — absent buckets/markets/fields are omitted, never zero-filled. 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.

## Query parameters

- `granularity` '5m' | '1h' | '1d'
- `days` integer
- `from` string, date
- `to` string, date

## Response `200`

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

- ProtocolState
  - `since` string, date, required
  - `until` string, date, required
  - `granularity` '5m' | '1h' | '1d', required
  - `series` object[], required
    - `ts` string, date-time, required
    - `markets` object[], required
      - `market` 'SOL' | 'cbBTC' | 'HYPE', required
      - `collateralRatio` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `levercoinLeverage` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `stablecoinNav` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `levercoinNav` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `virtualStablecoinSupply` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `levercoinSupply` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `totalCollateral` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `collateralPriceUsd` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `tvlUsd` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `usdcPeg` object
      - `vaultReserves` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `virtualStablecoinSupply` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `earnPool` object
      - `hyusdPoolBalance` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `ehyusdSupply` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
      - `ehyusdNav` string — Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.

## Other responses

- `400` — Invalid parameter.

---

[API](https://skmtc.dev/hylo/apis/hylo-public-api.md) · [All operations](https://skmtc.dev/hylo/apis/hylo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hylo/hylo-public-api/revisions/fe91f85eefd4/schema)