TickerDocs
Tools

get_event_sections_live

Shows open seats per section of one event: now, at a past moment, one section or general admission over time, or the house over a window.

When to use it

  • You want the house at a glance: which sections still have seats, at what prices, and how full each is. Leave view out.
  • You want where seats went: view at reads every section at a past moment, so call it twice and subtract.
  • You want one section over hours (view series), a general admission floor over time (view ga), or every section at each step of a window (view frames).
  • It replaces get_event_sections_at, get_event_section_series and get_event_ga_history, whose names still answer: see Old names.

Inputs

  • view (string): now (the default): each section right now. at: every section at a past moment. series: one section over time. ga: the general admission sections over time. frames: every section at each step of a window. One of now, at, series, ga, frames.
  • event_id (string, required): The event, by its Ticker id. Find it with search_events.
  • source (string): tm (the default) for the primary seat log, or mlb for a club's own primary market. With mlb, sections go by the name a fan reads, and view frames lists the primary market's seat frames. One of tm, mlb.
  • sections (array of strings): With now or frames, only these sections, by section_key, like 104 or FL2. Leave it out for the whole house.
  • limit (integer): With now, the most sections when you leave out sections: 60, at most 650. With ga, points per page: 200, at most 1,000. A larger value reads as the most.
  • all_in (boolean): With now, adds each section's lowest price after fees. Set false for the prices before fees alone.
  • at (date-time): With at, the moment to read, with a time zone. Leave it out for now. A moment more than 90 days ago reads as 90 days ago.
  • frame (string): With source mlb, one of the event's seat frames, as view frames lists it. get_event_seats takes the same value.
  • section (string): With series, the section's code, like 104 (required). With ga, a general admission section's code, like GAFLR3, to add its exact points.
  • bucket (string): With series, the step between points: 5m suits the last few hours and 1h suits days. An hour shows the section's state at the end of that hour, not an average. One of 5m, 1h.
  • since (date-time): With series, the oldest point, with a time zone; leave it out for the last 24 hours, and a start more than 7 days ago reads as 7 days ago. With frames, the oldest step; leave it out to span the event's own history, at most 90 days.
  • occurrence (integer): With ga, which copy of the code, when the event lists one code twice. Leave it out otherwise.
  • cursor (string): With ga, next_cursor from the page before, for the next, newer points. Use it with the same section and no width.
  • width (integer): With ga, instead of pages, the shape of the whole history in one answer: the time from the section's first point to now, cut into width equal slices, with the first, last, lowest and highest point of each. From 50 to 2000.
  • until (date-time): With frames, the newest step, with a time zone. Leave it out for now.
  • interval (string): With frames, the step between columns: 5m, 15m, 1h, 6h or 1d. One too fine for the window is widened, never the window shortened, and the answer's interval says which was served. One of 5m, 15m, 1h, 6h, 1d.
  • currency (string): usd or venue. For an event at a Canadian or UK venue, venue gives every price in the venue's currency (Canadian dollars or pounds) at one exchange rate for the event, so the cheapest market and any order stay the same, and the answer names currency, venue_currency, fx_rate and fx_rate_date. Leave it out for USD. Any other event is always in USD. One of usd, venue.

Examples

How many seats are open in each section right now, and what do they cost?

{ "event_id": "ev3rp4z4zhq1" }

Which sections had the most open seats last Friday at 7 pm Eastern?

{
  "event_id": "ev3rp4z4zhq1",
  "view": "at",
  "at": "2026-10-09T19:00:00-04:00"
}

How did each section fill up over the last three days, hour by hour?

{
  "event_id": "ev3rp4z4zhq1",
  "view": "frames",
  "since": "2026-10-25T00:00:00Z",
  "interval": "1h"
}

What comes back

  • now: one row per section with a seat open: section, open_count, min_price, median_price, max_price, capacity and percent_taken (taken, held back and withdrawn count the same), and with all_in the lowest price after fees. sections_total is the true count. available false means the event has no live seat reading, not an empty house.
  • sold_or_pulled with now: how many listings left the resale market in the last 24 hours and 7 days. A listing leaves when a buyer takes it or its seller withdraws it, and both count.
  • at: one row per section, most open seats first, with open_count, min_price and observed_at; a count carries forward from the section's last reading. total is null when some sections have no count.
  • series: points, oldest first, with at, open_count and prices. open_count is exact at every point; the newest point's prices are exact, and an earlier point's prices are the seats open now valued at that point's recorded prices.
  • frames: sections names the columns, and each step in frames has at, counts, min_prices and total in that order. A count carries forward between readings and null is no reading, never zero; steps_truncated true means older steps were cut to fit. With source mlb, seat_frames lists the primary market's seat frames instead.
  • ga: one summary per general admission section with its open count, peak and observed changes, and points when you name a section. Observed additions and removals show how the section changed over time.

Limits and quota

  • Reads only: it changes nothing.
  • Each call spends one MCP request.
  • A heavy tool: an account runs two at a time, and a third waits.
  • The Max plan and above include it.
  • A section with no seat open is not in the now list. ga covers general admission sections only, and reserved seats never appear there.
  • An input the view does not take is refused by name. For single seats, use get_event_seats.

On this page