---
title: "GET /stats/timeseries"
method: GET
path: "/stats/timeseries"
tags: ["Stats"]
---

# GET /stats/timeseries

`GET /stats/timeseries`

## Request

- Base URL: `https://arbitrum.gmxapi.io/v1`
- URL: `https://arbitrum.gmxapi.io/v1/stats/timeseries`
- Auth: none required
- TypeScript: <https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api/docs/stats/timeseries/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `metric` 'volume.perps' | 'volume.swaps' | 'volume.total' | 'fees.trading' | 'fees.swap' | 'fees.total' | 'revenue.protocol' | 'revenue.lp' | 'trades.perps' | 'trades.swaps' | 'users.active', required
- `groupBy` 'network' | 'version' | 'none'
- `networks` Network[]
- `versions` Version[]
- `from` number, double
- `to` number, double

## Response `200`

Success

- TimeseriesResponse
  - `groups` TimeseriesGroupResponse[], required
    - `points` TimeseriesPointResponse[], required
      - `provisional` boolean, required
      - `value` union, required
        - string
        - number, double
      - `day` number, double, required
    - `key` string, required
  - `groupBy` 'network' | 'version' | 'none', required
  - `interval` '1d', required
  - `metric` 'volume.perps' | 'volume.swaps' | 'volume.total' | 'fees.trading' | 'fees.swap' | 'fees.total' | 'revenue.protocol' | 'revenue.lp' | 'trades.perps' | 'trades.swaps' | 'users.active', required
  - `meta` SummaryMetaResponse, required
    - `schemaVersion` string, required
    - `sources` SourceStatusResponse[], required
      - `lastError` string, nullable, required
      - `lagSeconds` number, double, nullable, required
      - `health` 'fresh' | 'stale' | 'missing', required
      - `fetchedAt` number, double, nullable, required
      - `asOf` number, double, nullable, required
      - `metrics` MetricGroup[], required
      - `version` 'v1' | 'v2', required
      - `network` 'arbitrum' | 'avalanche' | 'megaeth' | 'solana', required
      - `id` string, required
    - `completeness` 'complete' | 'partial', required
    - `asOf` number, double, required

## Other responses

- `400`: Unknown metric, network, version or timestamp
- `500`: Internal Server Error
- `503`: Protocol stats are not available on this deployment

## Changes

- **2026-09-24** `93aad18dc79d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api/changes/stats/timeseries/get.md)

---

[API](https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api.md) - [All operations](https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gmx/apis/gmx-io-gmx-public-api/revisions/f140bd95ce1d?raw)