---
title: "Fee epochs."
method: GET
path: "/v1/analytics/veyb/fee/epochs"
tags: ["veyb"]
---

# Fee epochs.

`GET /v1/analytics/veyb/fee/epochs`

One row per funded fee epoch. `sortBy=epoch` and `date` are one order. Newest first. New rows only prepend, so dedupe on `id` while paging.

## Query parameters

- `chainId` string
- `limit` string — Integer 1-1000; outside is a 400, never clamped.
- `offset` string — Integer 0-10000; outside is a 400, never clamped.
- `isDesc` 'true' | 'false'
- `sortBy` 'date' | 'supply' | 'price' | 'value' | 'epoch'

## Response `200`

Fee epochs.

- object
  - `success` true, required
  - `data` object[], required
    - `id` string, required
    - `chainId` number, required
    - `epochNumber` number, required
    - `startTimestamp` number, required
    - `blockNumber` number, required
    - `blockTimestamp` number, required
    - `veYBSupplyAtSnapshot` string, nullable, required
    - `ybPriceAtSnapshot` string, nullable, required
    - `epochRewardsUsd` string, nullable, required
    - `lastMetricsUpdateAt` number, required
    - `tokens` object[], required
      - `tokenAddress` string, required
      - `amountRaw` string, required
      - `decimals` number, required
      - `amountUsdRaw` string, required
      - `priceUsdRaw` string, required
  - `totalCount` string, required
  - `timestamp` string, required

## Other responses

- `400` — Invalid request
- `500` — Internal error
- `502` — Upstream data/schema error

---

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