---
title: "Get tipping pool balance day-over-day"
method: GET
path: "/v1/leaderboard/pool/timeseries"
tags: ["leaderboard"]
---

# Get tipping pool balance day-over-day

`GET /v1/leaderboard/pool/timeseries`

Get daily pool balance (cumulative deposits - cumulative tips) for time-series charts (public, no auth).

- Returns the estimated pool balance at the end of each day.
- Computed as: cumulative deposits - cumulative tips up to that day.
- Also includes daily_deposits and daily_tips for each day.
- Useful for charts showing how the available tipping pool changes over time.
- Data points are ordered by date ascending (oldest first).
- `window` examples:
    - `24h`: pool balance for the last 24 hours (1 day)
    - `7d`: pool balance for the last 7 days
    - `30d`: pool balance for the last 30 days
    - `all`: all-time data

Note: This is a derived metric computed from fund_events and tip_events.
The current pool balance (`/pool/total`) may differ slightly due to timing.

## Query parameters

- `token` string — Token symbol to filter by.
- `window` '24h' | '7d' | '30d' | 'all' — Time window: '24h', '7d', '30d', or 'all' (all time).

## Response `200`

Successful Response

- PoolTimeseriesResponse — Response model for pool timeseries (day-over-day pool balance).
  - `token` string, required
  - `window` string, required
  - `data` PoolTimeseriesEntry[], required
    - `date` string, required
    - `pool_balance` string, required
    - `cumulative_deposits` string, required
    - `cumulative_tips` string, required
    - `daily_deposits` string, required
    - `daily_tips` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/revisions/f286b48a8105/schema)