---
title: "Index Revenue Timeseries"
method: GET
path: "/indices/{id}/revenue/timeseries/"
tags: ["Indices"]
---

# Index Revenue Timeseries

`GET /indices/{id}/revenue/timeseries/`

## Request

- Base URL: `https://api.modoenergy.com/pub/v1`
- URL: `https://api.modoenergy.com/pub/v1/indices/{id}/revenue/timeseries/`
- Auth: one of:
  - API key in header `X-Token`
  - none

Retrieves total index revenue for a specific index over a defined date range as a timeseries.

## Path parameters

- `id` integer, required

## Query parameters

- `interval_start` string, date-time, required
- `interval_end` string, date-time, required
- `capacity_normalisation` 'mw' | 'mwh'
- `time_basis` 'hour' | 'year'
- `breakdown` 'market'
- `markets` string
- `granularity` 'daily' | 'weekly' | 'monthly' | 'base'
- `cursor` string
- `limit` integer

## Response `200`

Success

- PaginatedIndexRevenueTimeseriesV2[]
  - `next` string, nullable: The link to the next page of results, or null if there is no next page.
  - `results` IndexRevenueTimeseriesV2, required
    - `units` string, required: Indicates the units in which revenue values are reported.
    - `records` IndexMarketRevenueTimeseriesV2[], required
      - `market` string, required: The market in which the asset participated to generate revenue.
      - `interval_start` string, date-time, required: The start of the time interval.
      - `interval_end` string, date-time, required: The end of the time interval.
      - `revenue` string, decimal, required: The revenue generated at each time interval.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

---

[API](https://skmtc.dev/modoenergy/apis/modo-energy-api.md) - [All operations](https://skmtc.dev/modoenergy/apis/modo-energy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/modoenergy/apis/modo-energy-api/revisions/7d9d1bd6ee06?raw)