Chelsea

English Premier League

Arsenal

Tipsme match id. Use it on every /matches/{matchId}/… endpoint.

Competition name in the requested language.

Competition name as published by the source.

Team name in the requested language (Accept-Language), falling back to the original.

scheduled, live, finished, postponed or cancelled — normalised, never a localised string.

Match minute while live, e.g. "63" or "45+2".

Stoppage time announced for the current half, in minutes.

Penalty shoot-out score, when one took place.

True when the fixture belongs to a knockout bracket.

True when the Hong Kong Jockey Club offers this fixture; HKJC odds exist only for these.

Home team PNG URL on assets.tipsme.hk, built from the original team name. Omitted when the original name is unavailable; the image may be unavailable.

Away team PNG URL on assets.tipsme.hk, built from the original team name. Omitted when the original name is unavailable; the image may be unavailable.

Exact competition name from a match’s competition.name or nameOriginal, ignoring letter case. Leave blank for all competitions. Example: Premier League. Discover IDs: https://tipsme.hk/developers/docs/fixtures

league

Filter by scheduled, live, finished, postponed or cancelled. Leave blank for all statuses. Example: live.

status

Numeric Tipsme match ID from a live or fixture list. Use it for match details, odds and analysis; analysis requires Plus or Pro. Example: 98224. Discover IDs: https://tipsme.hk/developers/docs/fixtures

matchId

Live scores and single-match status, with kickoff times and home and away team logos.

Live scores

Calendar date in YYYY-MM-DD format, interpreted using tz. Leave blank to include every date in the available schedule. Example: 2026-09-08.

date

Page number, starting at 1. Blank or values below 1 use page 1. Example: 1.

page

Items per page. Default 25, maximum 100; values above 100 are capped by the API. Example: 25.

pageSize

UTC offset in minutes for the date filter: 480 is Hong Kong (UTC+8), 0 is UTC. Kickoff timestamps in the response remain UTC. Example: 480.

Match lists filtered by date, league and status, with team logos and available live scores.

Fixtures

Goals, cards and substitutions in time order.

Event type for the home side (goal, yellow card, substitution…), when it was theirs.

Player and detail text for the home event.

Event type for the away side, when it was theirs.

Player and detail text for the away event.

Running technical tallies (shots, attacks…) over time.

Goals scored / conceded per 15-minute slice.

Share of the home side's season goals scored in this slice.

Share of the home side's goals conceded in this slice.

Share of the away side's goals scored in this slice.

Share of the away side's goals conceded in this slice.

Season-average metrics, home versus away.

True once the official lineups are published; false for predicted ones.

Coach identifier in the lineup data, when available.

Player identifier in the lineup data, when available.

Player name as available in the match lineup.

Position code, e.g. "GK", "DF", "MF", "FW".

Position on the pitch for the starting eleven; null for the bench.

Horizontal position, 0 (own goal line) to 100.

Vertical position, 0 (left touchline) to 100.

Deprecated: use events for normalized event names and grouped details. Retained for existing clients.

Upstream incident type code (goal, own goal, yellow, red, substitution…).

Stoppage minute when the incident fell in added time.

Home score after the incident (goals only).

Away score after the incident (goals only).

Normalized goals, cards, injuries and substitutions involving this player.

Event kind; unknown when no supported mapping is available.

Additional minute in stoppage time, when reported.

Home goals after the event, when reported.

Away goals after the event, when reported.

Assisting players in reported order; empty when none are reported.

Players coming on and going off, when reported.

Deprecated: use absences for unavailable players. Retained for existing clients.

Season rating, a different measure from the per-match rating.

Team rating in recent matches, most recent first.

Unavailable players with reported reasons and absence dates.

Reported injury, suspension or other absence description.

Previous meetings between the two sides, newest first.

How the meeting finished against the common markets.

Win / draw / loss from the home side's view.

Whether the home side covered the Asian handicap.

Whether the match went over or under the goals line.

Standings split by overall / home / away.

Match events, technical statistics, lineups and head-to-head history.

Match detail

When any price on this match last changed.

Bookmaker name; may carry a trailing asterisk. Use the numeric id from /odds/bookmakers in URLs.

Opening handicap line, e.g. "-0.5" (home gives half a goal).

Kelly index for the home outcome; above ~1.0 suggests the bookmaker rates it more likely than the market average.

Bookmaker payout rate (margin) for this quote.

Handicap or total line (hdp / hilo only).

Every observation after the opening, in time order.

Odds market: had = home/draw/away (1X2); hdp = Asian handicap; hilo = total goals over/under. Example: had.

market

Use the numeric ID from /odds/bookmakers, or the exact bookmaker name from the odds response. Special characters are encoded automatically. Example: 2. Discover IDs: https://tipsme.hk/developers/docs/odds#getoddsbookmakers

bookmaker

Kitchee

Permanent numeric id — part of the public contract, never renumbered.

The raw stored name: the exact string used in movement URLs, Redis
    keys and the SQL `company` column. CJK and `*` are literal.

True for the Min/Max envelope rows, which are not real
    bookmakers but occupy the same namespace in the stored data.

1X2, handicap and goals odds, movement history, Kelly, HKJC and exchange data.

Odds

Illustrative analysis report. This sample does not describe a real prediction.

Language of the stored text: en, zh-CN or zh-HK.

Stored report text, which may contain Markdown.

Numeric Tipsme match id; the same id accepted by the match endpoints.

Eligible grouped counts; empty when no sample exceeds the reporting threshold.

Stored market label, such as 讓球 or 入球大細.

Handicap line of this tip group; omitted when not applicable.

Goal-total line of this tip group; omitted when not applicable.

Number of Tipsme tips in this outcome and line group.

Bookmakers with a published dataset; source coverage may differ between markets.

Matches across competitions selected by the opening line.

Stored historical match date/time string; no timezone conversion is applied.

Stored Asian market line, retaining split-line formatting.

Opening line used to select the historical sample.

Reported sample size; omitted when unavailable.

Home wins in the reported historical sample.

Away wins in the reported historical sample.

Stored handicap win-rate string, which may include a percent sign.

Stored handicap push-rate string, which may include a percent sign.

Stored handicap loss-rate string, which may include a percent sign.

Reported win rate keyed by number of recent matches.

Reported distribution keyed by odds-deviation threshold.

Matches from the same competition selected by the opening line.

Matches across competitions with matching opening and closing lines.

Matches from the same competition with matching opening and closing lines.

Odds for the over outcome, when reported.

Odds for the under outcome, when reported.

Precomputed sample counts and rates, when reported.

Matches recorded as over the total-goals line.

Matches recorded as under the total-goals line.

Stored over-result rate string, which may include a percent sign.

Stored under-result rate string, which may include a percent sign.

Reported win-rate chart series keyed by number of recent matches.

Reported chart distribution keyed by opening/closing odds-deviation threshold.

Corner analysis for the current home team.

Historical corner sample when this team played at home.

Reported number of historical matches at this venue; zero and missing are distinct.

First-corner counts keyed by match minute, when reported.

Corners earned by the team, aggregated by match minute.

Corners conceded by the team, aggregated by match minute.

Individual historical-match corner counts keyed by minute, without match or user identifiers.

Historical corner sample when this team played away.

Combined corner counts at each minute across the home and away venue samples.

Corner analysis for the current away team.

Basic and deep AI reports, user tip distribution, and handicap, goals and corner analysis. Plus and Pro only.

Analysis

Base requests per account per Hong Kong calendar day.

Requests per minute per API key; applies to base and bonus requests.

One unrevoked API key per consumer; expired keys count until revoked.

Extra free GET /v1/football/matches requests per consumer per Hong Kong day for this tier, used before the base allowance.

Feature entitlements enforced for this tier.

Whether this tier may call the Analysis endpoints.

Plan version; prices change by inserting a new version.

List price while the plan is on promotion.

Percentage off the compare-at price, when the plan is on promotion. Computed here so
the tag on the card can never disagree with the two prices printed beside it.

Saving of the yearly plan versus twelve monthly payments.

How long a plan change takes to reach enforcement.

The Free tier's fixture-list allowance. Deprecated: each tier's own value is in `tiers[].limits.freeMatchesDailyQuota`; this stays for clients built before the allowance was per tier.

Public plan prices, request limits and analysis access for Free, Plus and Pro.

試玩區

由免費方案開始