---
title: "GET /api/feed/v1/events/{eventId}/seller-series"
method: GET
path: "/api/feed/v1/events/{eventId}/seller-series"
tags: ["Feed"]
---

# GET /api/feed/v1/events/{eventId}/seller-series

`GET /api/feed/v1/events/{eventId}/seller-series`

## Request

- Base URL: `https://api.findticker.com`
- URL: `https://api.findticker.com/api/feed/v1/events/{eventId}/seller-series`
- Auth: HTTP bearer

## Path parameters

- `eventId` string, required

## Query parameters

- `hours` integer

## Response `200`

How this event's sellers moved, hour by hour: how many held inventory in each hour, how many of its tickets had a known seller of record, and one line per seller with what it held. A seller gets a line once it has been among the five largest of an hour, or once it has grown into the event without reaching them, and it keeps that line for the rest of the window. Null when the event has no readings yet, which is the common case. Lines are lettered by the order they first appear, not ranked, and a seller keeps its letter whatever window is asked for, so the same letter always means the same seller. A letter missing from the run is a seller this window has nothing for. No seller is named or identified. Costs one unit.

- FeedEventSellerSeries
  - `event_id` string, nullable, required
  - `series` FeedSellerSeries, required
    - `points` FeedSellerSeriesPoint[], required: One point per hour, oldest first and unbroken between the ends of the window, so an hour with no reading is a point with nulls in it rather than a point that is absent.
      - `hour` string, required: The hour this point reports, on the hour, UTC.
      - `distinct_sellers` integer, nullable, required: How many distinct sellers held inventory in this hour. Null when there is no reading for the hour, which is a gap in the record rather than an hour with no sellers.
      - `coverage_pct` number, nullable, required: Share of this hour's tickets whose seller of record was known, 0 to 1. Reported beside the counts; it is never a reason to withhold them.
      - `attributed_tickets` integer, nullable, required: How many tickets in this hour had a known seller of record: the total the counts below are parts of. Tickets held by sellers without a line of their own are the difference between this and the sum of those counts. Null when there is no reading for the hour, never zero.
      - `tickets` object, required: Tickets held in this hour, keyed by the line label. Zero means the line was in the window and held nothing this hour. Null means the line had not begun, or there is no reading for this hour at all.
    - `sellers` FeedSellerSeriesLine[], required: The lines, in arrival order.
      - `label` string, required: What to call this line. A letter assigned by the order the sellers first appeared. It is an arrival order and not a rank, and it does not match a wedge on the concentration reading. A seller keeps its letter whatever window is asked for, so the same letter always means the same seller; a letter missing from the run is a seller this window has nothing for. Labels do not carry across events.
      - `peak_tickets` integer, required: The most tickets this line held at any hour in the window.
    - `as_of` string, required: The newest hour this answer covers.
  - `meta` object, required
    - `units_charged` integer, required

## Other responses

- `400`: Validation error, an unknown `columns` name (the message lists the valid set), or a batch over the size bound.
- `401`: Missing or invalid API key.
- `402`: The account's plan does not include this reading. `required_tier` names the plan that does; the same payload the MCP tools answer.
- `403`: The key's account is not entitled to the feed, or the account or the address it calls from is blocked (`reason` `blocked`).
- `404`: No such event.
- `429`: The per-minute burst ceiling or the unit budget for the current UTC date is used up.
- `500`: Internal Server Error.

---

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