chinasportslottery

China Sports Lottery

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.

get/chinasportslottery

Request

  • Base URL: https://api.5dollarfootballapi.com/v1
  • URL: https://api.5dollarfootballapi.com/v1/chinasportslottery
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

start_timeinteger

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_timeinteger

Window end as a unix timestamp (seconds, UTC), exclusive. Defaults to start_time + 24h. The window may span at most 24 hours.

typesstring

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.

leagueinteger

Filter by league id.

statusstring

all | scheduled | live | finished | unknown. Defaults to all; "live" returns every in-play match on sale right now, regardless of the window.

includestring

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.

langstring

Localize team & league names (21 languages, English fallback).

pageinteger

Pagination (per_page max 100; 50 with include). Ordered by kickoff, oldest first, exactly like /v1/fixtures.

per_pageinteger

Pagination (per_page max 100; 50 with include). Ordered by kickoff, oldest first, exactly like /v1/fixtures.

Response

Success

success1 required

Changes

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