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

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

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

## Request

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

## Path parameters

- `eventId` string, required

## Response `200`

How concentrated this event's inventory is among the sellers behind it: how many are active, what share the largest one and the largest three hold, how many tickets those shares are shares of, the concentration index and the band it falls in, and how much of the inventory could be attributed to a seller at all. Null when the event has no reading yet, which is the common case. No seller is named, ranked or identified, and the stored row holds no seller id. Costs one unit.

- FeedEventSellerConcentration
  - `event_id` string, nullable, required
  - `concentration` FeedSellerConcentration, required
    - `sellers_active` integer, required: How many distinct sellers hold inventory for this event.
    - `attributed_tickets` integer, nullable, required: How many tickets the shares below are shares of. Null when the stored row cannot give the count.
    - `coverage_pct` number, required: How much of the event's inventory could be attributed to a seller at all, 0 to 1. A low value means the shares below describe a small part of the house, so read them together.
    - `top1_share` number, required: Share of attributed tickets held by the largest seller, 0 to 1.
    - `top3_share` number, required: Share of attributed tickets held by the largest three, 0 to 1.
    - `hhi` number, required: Herfindahl-Hirschman index over the attributed sellers, on the same 0 to 1 scale.
    - `shape` string, required: The band hhi falls in: spread, concentrated or dominated.
    - `as_of` string, required: When the inputs were read.
  - `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)