China Sports Lottery

GET /v1/chinasportslottery

The /v1/fixtures window narrowed to matches on sale in China's state football lotteries, each with its official lottery numbers and the official China Sports Lottery Jingcai (竞彩) 1X2 prices. China Sports Lottery Jingcai (竞彩) is the fixed-odds football lottery with a published price per match; Beijing Single Match (北单) is the Beijing lottery's single-match pool; the Traditional football lottery (传统足球) is the 14-match pool. Same parameters, order and pagination as /v1/fixtures, plus types. Ultra plan and above.

Parameters

start_time	optional	Window start as a unix timestamp (seconds, UTC), inclusive. Defaults to 00:00 UTC today; if only end_time is sent, defaults to 24h before it.
end_time	optional	Window end as a unix timestamp (seconds, UTC), exclusive. Defaults to start_time + 24h. The window may span at most 24 hours.
types	optional	Comma list of jingcailottery (竞彩) \| beijingsingle (北单) \| traditional (传统足球). Defaults to all three. A fixture is returned when it carries a number for at least one of them, and the lottery block lists only the requested ones.
league	optional	Filter by league id.
status	optional	all \| scheduled \| live \| finished \| unknown. Defaults to all; "live" returns every in-play match on sale right now, regardless of the window.
include	optional	Comma list of odds \| events \| stats — the same expansions as /v1/fixtures (odds is the Bet365 block, not the Jingcai prices, which are always inline). Caps per_page at 50.
lang	optional	Localize team & league names (21 languages, English fallback).
page, per_page	optional	Pagination (per_page max 100; 50 with include). Ordered by kickoff, oldest first, exactly like /v1/fixtures.

Notes

Numbers are the official labels, returned as strings. The Jingcai number's weekday prefix follows the lottery's sales day, not the kickoff date, so an early-morning Sunday kickoff in Beijing time can still be 周六 (Saturday).
closing is the latest pre-match price until kickoff, then frozen — the same as every other market. at is the time of that quote, unix seconds UTC; ticks counts the pre-match quotes recorded.
odds is null when a match has a Jingcai number but no official price on record.
Beijing Single Match and the Traditional football lottery carry the serial number only for now — no issue number and no prices.
Prices are the official Jingcai 1X2 only; other Jingcai markets are not carried. The full price path between opening and closing is on /v1/fixtures/{id}/odds/history?bookmaker=chinasportslottery&market=1x2, and /v1/fixtures/{id}/odds?bookmakers=chinasportslottery returns the same book alongside the others.
esports is not accepted (the lotteries never cover esoccer) and returns 400 unknown_parameter, as do from, to, date, team and live.
Requires the Ultra plan or above; other plans get 403 insufficient_plan.

Example

GET /v1/chinasportslottery

curl https://api.5dollarfootballapi.com/v1/chinasportslottery
  -H "Authorization: Bearer fb_live_your_key"

{
  "success": 1,
  "data": [
    {
      "id": 3335649313,
      "league": { "id": 80636319, "name": "UEFA Nations League A" },
      "teams": { "home": { "id": 2254257989, "name": "England" }, "away": { "id": 3596550507, "name": "Spain" } },
      "kickoff_utc": "2026-09-26T18:45:00+00:00",
      "kickoff_ts": 1790448300,
      "status": "finished",
      "status_reason": null,
      "status_code": "full",
      "goals": { "home": 2, "away": 3, "half_home": 2, "half_away": 1 },
      "corners": { "home": 6, "away": 3, "half_home": 3, "half_away": 3 },
      "cards": { "home": { "yellow": 3, "red": 0 }, "away": { "yellow": 0, "red": 0 } },
      "lottery": {
        "jingcailottery": {
          "number": "周六016",
          "odds": {
            "opening": { "home": 2.7, "draw": 3.2, "away": 2.25, "at": 1790300220 },
            "closing": { "home": 3.46, "draw": 3.4, "away": 1.83, "at": 1790433120 },
            "ticks": 12
          }
        },
        "beijingsingle": { "number": "87" },
        "traditional": { "number": "7" }
      }
    }
  ],
  "pagination": { "page": 1, "per_page": 50, "count": 1, "has_more": true }
}

// kickoff 02:45 on Sunday in Beijing, sold under Saturday's numbers: 周六016

Need a key? Create a free account — a working key is issued instantly, no card required.

← All documentation Pricing →

China Sports Lottery