Tools
get_event_chart
Charts one event over time, one row per date: its prices and inventory, or its demand.
When to use it
- You want the price path of one event: how its median and lowest prices and its listings moved, from the source you pick.
- You want to see whether demand for one event is building or fading: set
metrictodemand. - For one section in finer steps, use
get_event_sections_livewithviewseries. For the event's other numbers over time, useget_event_analyticswithrange. - It replaces
get_event_price_chartandget_event_demand_chart, whose names still answer: see Old names.
Inputs
metric(string):price(the default) for prices and inventory,demandfor interest in the event's listings and recent ticket sales. One ofprice,demand.event_id(string, required): The event, by its Ticker id (evplus ten characters), assearch_eventsand the other tools return it.range(string): How far back the series reaches: 90 days forpriceand 28 days fordemandwhen you leave it out.allreaches back up to one year. For an event that has taken place, it counts back from the event date. Withpriceit applies tovsonly: the other sources always answer their full history. One of7d,14d,28d,90d,all.source(string): Withprice, the market the prices come from.vs,tp,tmr,gt,sgandshare the resale market;tm,mlb(the team's own box office for a baseball game) andsgpare the primary market. Never put a primary and a resale source in one series. It does not apply todemand. One ofvs,tp,tm,tmr,gt,sg,sh,mlb,sgp.render(boolean): Include a chart image ahead of the data. Setfalsefor the data only, a smaller answer.
Examples
How has the price of this concert moved over the last 90 days?
{ "event_id": "ev3rp4z4zhq1" }Is demand for this game building or fading? Data only, no chart.
{ "event_id": "ev5t9h2w7k3c", "metric": "demand", "render": false }What is left on the primary market for this show, and at what price?
{ "event_id": "ev8k2m4q7x1a", "source": "tm" }What comes back
- With
priceandvs: one row per date, oldest first.median_priceand the middle half of prices (p25_pricetop75_price) are averages across that date;lowest_priceandlowest_aip_priceare its low. Anaipprice is all-in, what the buyer pays. Each row also carrieslistings_min,listings_max,tickets_min,tickets_maxandpercent_remaining. - With
priceand any other source:source,metaandseries, a list ofdate,floor,median,p25,p75,listingsandtickets, with no image.meta.mappedfalsemeans the event has no link to that source. - With
demand: one row per date withsnapshot_date,interestandsales. Each is a level over a recent window, not a count for that date: read the change from one date to the next as momentum, and never report a value as tickets bought that day. days_missinglists the dates in the span with no row: treat each as a gap and never fill it in.event_name,local_dateandvenue_namename the event, so a chart legend reads a name, not an id.- A chart image comes first unless
renderisfalse.rowsis empty when the event has no history.
Limits and quota
- Reads only: it changes nothing.
- Each call spends one MCP request.
- Every plan reads the full
vsseries and demand. The Pro plan and above includetp; the Max plan and above includetm,tmr,gt,sg,sh,mlbandsgp. A source your plan does not include is refused with aplan_requirederror. - Demand history starts on 2026-07-17, so long demand ranges are short for now.
- The Max plan and above include events that have already taken place.
- An input the metric does not take, like
sourcewithdemand, is refused by name.