TickerDocs
Tools

check_coverage

Checks up to 1,000 events at once: the event each one names and the markets Ticker reads for it.

When to use it

  • Someone hands you their events, as ids or links, and asks which of them Ticker covers.
  • You want to know, before you pull numbers, which markets Ticker reads for each of a list of events.
  • To find one event by its name, use search_events.

Inputs

  • refs (array of strings, required): The events to check, 1 to 1,000. Each one is a Ticker event id (ev plus ten characters), a marketplace id with its source prefix (vs:, tm:, sh:, sg:, gt:, tp: or ax:), or a marketplace event link. Up to 1000 items.

Examples

Which of these events does Ticker cover?

{ "refs": ["ev3rp4z4zhq1", "ev8k2m4q7x1a"] }

Does Ticker read this event on every market?

{ "refs": ["ev3rp4z4zhq1"] }

What comes back

  • rows, one per ref, in the order you sent them. Each row has ref, the event it names (event_id, name, date, venue and status), has_tm_id, and markets: each market Ticker reads for the event that your plan includes, with last_read_at, when its newest read answered.
  • A ref that names no event has a null event_id, miss (invalid or not_found) and miss_reason, one line saying why.
  • summary: how many refs you sent, how many named an event, how many of those hold a TM id, and a count per market.

Limits and quota

  • Reads only: it changes nothing.
  • Each call spends one MCP request.
  • At most 1,000 refs in one call.
  • Lists only the markets your plan includes. A marketplace id or link from a market your plan does not include is not read, and its row says so.

On this page