---
title: "Open dataset of closed events"
method: GET
path: "/receipts/dataset"
tags: ["Receipts"]
---

# Open dataset of closed events

`GET /receipts/dataset`

## Request

- Base URL: `https://tickerz.com/api/v1`
- URL: `https://tickerz.com/api/v1/receipts/dataset`
- Auth: none declared

One flat row per closed event (cooling or resolved); returns stay null until each receipt resolves. Includes hidden assets with display=false. Omits trigger z-scores. Paginate with limit and offset. First export window starts 2026-08-27.

## Query parameters

- `since` string, date
- `format` 'json' | 'csv'
- `limit` integer
- `offset` integer

## Response `200`

Dataset page. CSV when format=csv, with Content-Disposition attachment.

- ReceiptsDatasetResponse
  - `rows` ReceiptsDatasetRow[]
    - `event_id` string, uuid
    - `opened_at` string, date-time
    - `symbol` string
    - `name` string
    - `class` 'crypto' | 'equity'
    - `display` boolean: false for hidden assets
    - `heat_at_open` number: Deprecated. Despite the name this is the peak activity score while the event was open, equal to peak_score. Use score_at_open for the opening score. Remains until at least 2026-12-31.
    - `reference_price` number: Frozen price at open, USD
    - `ret_24h` number, nullable: Percent return at 24h, null until resolved
    - `resolved_24h` string, date-time, nullable
    - `ret_7d` number, nullable
    - `resolved_7d` string, date-time, nullable
    - `ret_30d` number, nullable
    - `resolved_30d` string, date-time, nullable
    - `score_at_open` integer, nullable: Activity score of the tick that opened the event
    - `peak_score` number: Highest activity score while the event was open
    - `benchmark` 'BTC' | 'SPY' | 'null', nullable: BTC for crypto, SPY for stocks. Null until the benchmark fill has run
    - `benchmark_ret_24h` number, nullable: The benchmark's percent return over the same window as ret_24h, null until filled
    - `benchmark_ret_7d` number, nullable: The benchmark's percent return over the same window as ret_7d, null until filled
    - `benchmark_ret_30d` number, nullable: The benchmark's percent return over the same window as ret_30d, null until filled
  - `next_offset` integer, nullable: Next page offset, or null when done
  - `halted` boolean: true when the database is not connected
  - `since` string, date: Effective since after clamping

## Other responses

- `429`: rate_limited: the address passed the limit named in RateLimit-Policy
- `500`: internal_error: the server failed to answer
- `503`: Database not connected; halted=true

---

[API](https://skmtc.dev/tickerz/apis/tickerz-api.md) · [All operations](https://skmtc.dev/tickerz/apis/tickerz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickerz/apis/tickerz-api/revisions/075e6b98557d?raw)