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
viewout. - You want where seats went:
viewatreads every section at a past moment, so call it twice and subtract. - You want one section over hours (
viewseries), a general admission floor over time (viewga), or every section at each step of a window (viewframes). - It replaces
get_event_sections_at,get_event_section_seriesandget_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 ofnow,at,series,ga,frames.event_id(string, required): The event, by its Ticker id. Find it withsearch_events.source(string):tm(the default) for the primary seat log, ormlbfor a club's own primary market. Withmlb, sections go by the name a fan reads, andviewframeslists the primary market's seat frames. One oftm,mlb.sections(array of strings): Withnoworframes, only these sections, bysection_key, like104orFL2. Leave it out for the whole house.limit(integer): Withnow, the most sections when you leave outsections: 60, at most 650. Withga, points per page: 200, at most 1,000. A larger value reads as the most.all_in(boolean): Withnow, adds each section's lowest price after fees. Setfalsefor the prices before fees alone.at(date-time): Withat, 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): Withsourcemlb, one of the event's seat frames, asviewframeslists it.get_event_seatstakes the same value.section(string): Withseries, the section's code, like104(required). Withga, a general admission section's code, likeGAFLR3, to add its exactpoints.bucket(string): Withseries, the step between points:5msuits the last few hours and1hsuits days. An hour shows the section's state at the end of that hour, not an average. One of5m,1h.since(date-time): Withseries, 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. Withframes, the oldest step; leave it out to span the event's own history, at most 90 days.occurrence(integer): Withga, which copy of the code, when the event lists one code twice. Leave it out otherwise.cursor(string): Withga,next_cursorfrom the page before, for the next, newer points. Use it with the samesectionand nowidth.width(integer): Withga, instead of pages, the shape of the whole history in one answer: the time from the section's first point to now, cut intowidthequal slices, with the first, last, lowest and highest point of each. From 50 to 2000.until(date-time): Withframes, the newest step, with a time zone. Leave it out for now.interval(string): Withframes, the step between columns:5m,15m,1h,6hor1d. One too fine for the window is widened, never the window shortened, and the answer'sintervalsays which was served. One of5m,15m,1h,6h,1d.currency(string):usdorvenue. For an event at a Canadian or UK venue,venuegives 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 namescurrency,venue_currency,fx_rateandfx_rate_date. Leave it out for USD. Any other event is always in USD. One ofusd,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,capacityandpercent_taken(taken, held back and withdrawn count the same), and withall_inthe lowest price after fees.sections_totalis the true count.availablefalsemeans the event has no live seat reading, not an empty house.sold_or_pulledwithnow: 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, withopen_count,min_priceandobserved_at; a count carries forward from the section's last reading.totalis null when some sections have no count.series:points, oldest first, withat,open_countand prices.open_countis 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:sectionsnames the columns, and each step inframeshasat,counts,min_pricesandtotalin that order. A count carries forward between readings andnullis no reading, never zero;steps_truncatedtruemeans older steps were cut to fit. Withsourcemlb,seat_frameslists the primary market's seat frames instead.ga: one summary per general admission section with its open count, peak and observed changes, andpointswhen you name asection. 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
nowlist.gacovers 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.