---
title: "Bounded ticker bucket view: both cohort summaries, one cohort top-contract page, or one cohort trade page; truncated preserves the selected source cohort ceiling. Date parameters are ET trading dates in YYYY-MM-DD form. Currently limited to configured administrator user IDs."
method: GET
path: "/v1/flow/tickers/{ticker}/bucket"
---

# Bounded ticker bucket view: both cohort summaries, one cohort top-contract page, or one cohort trade page; truncated preserves the selected source cohort ceiling. Date parameters are ET trading dates in YYYY-MM-DD form. Currently limited to configured administrator user IDs.

`GET /v1/flow/tickers/{ticker}/bucket`

## Path parameters

- `ticker` string, required

## Query parameters

- `session_date` union
  - string, date
  - string, date-time
- `window` 'day' | '1m' | '5m' | '15m' | '30m' | '60m', required
- `bucket_start_micros` integer
- `section` 'summary' | 'top_contracts' | 'trades'
- `cohort` 'rest' | 'zero_dte'
- `limit` integer
- `cursor` string

## Response `200`

object payload

## Other responses

- `400` — validation error
- `401` — authentication error
- `402` — subscription paused
- `403` — scope insufficient
- `429` — rate limited or quota exhausted

## Changes

- **2026-09-20** `bf1aa24fe417` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/changes/v1/flow/tickers/:ticker/bucket/get.md)

---

[API](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api.md) · [All operations](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/revisions/bf1aa24fe417?raw)