I. API Overview
Introduction to the Boyi API service and data sources
The Boyi Official API Lottery Interface (www.byw.bet) is an official platform that provides lottery draw data services via web access to online media, lottery industry clients, third-party lottery sales platforms, and data analysis organizations. It is a professional China-based lottery API service designed for lottery-related websites, developers, and data analysts.
By default, Boyi's lottery draw data is sourced from official provincial welfare lottery (彩福) and sports lottery (体彩) centers. If any lottery game is discontinued by the relevant authority, we may stop providing the corresponding data interface without prior notice to users.
II. API Restrictions
Rate limits, concurrency, and usage guidelines
The Boyi Official API Lottery Interface (paid service) requires registration or application approval before the draw results can be accessed.
The Boyi Official API Lottery Interface (paid service) provides draw results in near real time with zero internal delay, typically 1-5 seconds ahead of the official source. However, due to network or other technical factors, occasional delays of a few seconds may occur.
Each registered account is limited to no more than 3 concurrent IP addresses per lottery per day.
The "Latest Query" interface is designed for frequent requests. Each IP must wait at least 1 second between requests to the same endpoint; a 5-10 second interval is recommended.
The "Date-Based Query" interface is intended only for data backfill. Each IP must wait at least 10 seconds between requests; a 30-40 second interval is recommended.
III. Purchase & Trial
How to get API access
The self-service trial feature is now available. Users who need a trial account can visit the "Free Trial Channel" to apply and obtain trial API access.
The self-service purchase feature is now available. Users who need to subscribe can visit the "Lottery API Purchase Page" to review purchase details.
IV. Demo Downloads
SDK sample code packages in multiple languages
We provide complete sample code in multiple languages for server-side and mobile scenarios. Click to download.
V. Developer Section
Open-source SDKs and developer documentation
Comprehensive open-source SDKs and sample code for developers to quickly integrate lottery draw data API.
VI. Disclaimer
Please read carefully before using the API
Before using the Boyi Official API Lottery Interface, please read and fully understand this statement carefully. You may choose not to use the Boyi Official API Lottery Interface; however, if you use it, your usage will be deemed as acceptance of all the terms in this statement.
- Except for the service terms expressly stated by the Boyi Official API Lottery Interface, Boyi shall not be liable for any accidents, negligence, infringement, or resulting losses arising from the use of the API.
- Any third-party webpages linked through the Boyi Official API Lottery Interface are created or provided by third parties. Boyi assumes no responsibility for their legality or legal liability.
- Any organization or individual who believes that content linked through the Boyi Official API Lottery Interface infringes upon their information network dissemination rights should promptly submit a written rights notification to Boyi.
- Users explicitly agree that all risks arising from their use of this website's network services shall be borne entirely by themselves. Boyi assumes no liability to users.
- Any personal data leakage or loss resulting from you disclosing your account or password to others or sharing your registered account with others.
- Any personal data leakage, loss, theft, or tampering caused by force majeure events such as hacker attacks, computer virus intrusion, or temporary shutdowns mandated by government authorities.
- Any personal data leakage caused by other websites linked to this website, and any resulting legal disputes or consequences.
- All lottery draw APIs on this website are provided by official welfare lottery authorities. If draw results contain errors, missed draws, hacker intrusions, or other force majeure events, this website shall not bear any economic loss or legal liability.


