Market data

List events

Lists the events that currently have prices. Each entry is the object the stream sends as ["event", {...}].

For price-sensitive work, use the streaming API: it pushes each change as it happens.

ir_status keeps the events in running (in_running) or not yet started (pre_event), the same values each event carries.

event_type gives the shape. A normal (match) event has home and away. A multirunner (outright) event has teams and end_time.

Page with limit and after: pass the previous page's last "{sport},{event_id}" as after. A page shorter than limit is the last one. The response has no total count.

event_id and competition_id filters need sport; a request without it gets a 400. Every entry has its sport, so a follow-up call can always supply it. Paging without filters needs no sport.

A filter that matches no event returns an empty data. This includes a sport, competition or event that has no prices at the moment. Each event_id must have the form an event carries, such as 2026-06-15,1001,2002; any other form gets a 400.

get/v2/events/

Request

  • Base URL: https://magicmarkets.com (the document declares no server; this is the origin it was published from)
  • URL: https://magicmarkets.com/v2/events/
  • Auth: API key in header X-Api-Key

Query parameters

sportstring[]

Sport codes to keep. Repeatable, up to 100 values; omit for every sport. Required alongside event_id or competition_id. See "Sports & bet types" in the introduction.

competition_idinteger[]

Competitions to keep. Repeatable, up to 100 values; omit for every competition. Requires sport.

event_idstring[]

Events to keep. Repeatable, up to 100 values; omit for every event. Requires sport. Each value is an event's event_id, such as 2026-06-15,1001,2002; any other form gets a 400.

lang'en' | 'zh-hans' | 'ko'

Language for competition and team names.

limitinteger

Events per page.

afterstring

Cursor - the previous page's last "{sport},{event_id}".

start_time_fromstring date-time

Keep events starting at or after this instant, 1970 or later. An event whose start time is unknown is never inside a window.

start_time_tostring date-time

Keep events starting before this instant, 1970 or later. The window is half-open, so an event starting exactly at this instant is excluded.

ir_status'pre_event' | 'in_running'

Keep events with this ir_status. Omit for both.

Response

Events with prices

status'ok'

Changes

No recorded changes to this operation across all 1 revision of this API.