List the fixtures for a calendar day — or a bounded [date, date_to] range.
Unlike list_today_matches (today + anything still live), this is a strict window for whatever
``date`` you ask for. Pass ``date_to`` (inclusive, max 31 days after ``date``) to cover a whole
tournament window in ONE call — "all group-stage matches June 11–28" needs no per-day loop. UTC
is canonical: pass an IANA ``timezone`` and the day boundaries are computed in that zone (so
"June 12 in Shanghai" excludes a match that is still June 11 / already June 13 locally); each
fixture keeps its UTC ``scheduled_at`` and adds ``scheduled_at_local``. Capped to ``limit``
(``truncated`` flags overflow) — narrow with sport/status/league rather than paging.
Args:
date: REQUIRED calendar day "YYYY-MM-DD" (e.g. "2026-06-12") — the window start.
date_to: optional inclusive end day "YYYY-MM-DD" (max 31 days after ``date``); omit for a
single day.
timezone: optional IANA timezone (e.g. "Asia/Shanghai", "America/New_York") for the day
boundary; default is the UTC day.
sport: optional filter — "football" or "basketball".
status: optional filter — "scheduled", "live" or "finished".
league: optional league filter — a name (fuzzy-matched, e.g. "World Cup") or an external id ("lg_…").
limit: max fixtures to return (1–200, default 50).
Connector