Overview

Antscore API

Antscore API Provides developers with interfaces for both HTTP and WebSocket protocols, allowing them to access various types of data services. The returned results support the JSON format.

We recommend choosing the data retrieval protocol based on the application scenario (you can also use a combination). Primarily use HTTP to retrieve data; for data with low update frequency, use the HTTP protocol, while high-frequency or real-time data should be retrieved through WebSocket.。

The Antscore API is open to all users. Before using this set of services, you need to apply for an app_id and app_secret. Different types of users can obtain different levels of data access capabilities.

HTTP Protocol

Request Parameters

PARAM	VALUE
base_url *	https://sportsapi.antscore.co
app_id	Obtained from the console, used for identity verification
app_secret	Obtained through a business application, used for permission verification

All global interfaces support both HTTP and HTTPS. Each interface requires the transmission of app_id and app_secret to verify interface permissions. Data can only be accessed by making requests from whitelisted IPs (proxy mode is not supported).

Response Structure

PARAM	VALUE
code	Status Code
data	Main Returned Data
msg	Request Status

websocket

WSConnection Parameters

PARAM	VALUE
base_url *	wss://sportsws.antscore.co
app_id	Obtained from the console, used for identity verification
app_secret	Obtained through a business application, used for permission verification

All global WebSocket addresses support both WS and WSS. Each WebSocket requires the transmission of app_id and app_secret to verify WebSocket permissions. Data can only be accessed by subscribing from whitelisted IPs (proxy mode is not supported).

Global Response Structure

PARAM	VALUE
channel	Push Type
push_type	Push Types (new for additions; update for changes)
data	Main Returned Data
push_time_millis	Push Time, millisecond-level timestamp

Account and Key#

Registering as a Antscore developer requires 3 steps:

Step 1: Register as a developer
After registration, please go to the console to bind a business representative.

Step 2: Contact the business representative to activate permissions
Contact the business representative to apply for the product you want to try. Once the trial is activated, you can generate the app_id and app_secret in the console, along with the trial permissions for the product.

Step 3: Configure the IP whitelist
In the console under access management, set the access IPs. Each customer can configure up to 3 access IPs (production environment, testing environment, pre-release environment).

SDK-Demo

We provide integration demos for JAVA, PHP, and GOlang SDKs. For other languages, you can implement them yourself. For details, refer to the integration guide.

Usage Restrictions

Integration Restrictions

Except for animated live broadcasts and embedded components, other interfaces and push notifications cannot be directly applied to the front end. All data must be pulled to the user's server and then integrated into the user's product front end through development.

Request Rate Limits

Total request frequency per minute: 1200 requests (for the same app_id).

Request frequency per individual API: Each interface has its own request frequency limit. Refer to the specific interface documentation for details.
For more information, see the integration guide.

WebSocket Connection Limits

For the same data on the same IP, only one client connection is allowed to be online.

After all WebSocket connections are disconnected, wait a few seconds before reconnecting. Continuous reconnection is not allowed.

Request frequency per individual API: Each interface has its own request frequency limit. Refer to the specific interface documentation for details.
For more information, see the integration guide.

Notes

To better serve users, basic service call volumes have certain limits. If you require higher service call volumes, please contact the business representative to upgrade your account.

This product is for the user's own use only. It is strictly prohibited to share or sell it to others.

Use of this product must strictly comply with local laws and regulations. We have zero tolerance for illegal activities. You must ensure that your application, as well as your use of this service, related content, related data, related products, and any behavior or purpose involving this product, does not violate any applicable laws, regulations, rules, norms, policies, administrative orders, regulatory requirements, mandatory national standards, or other legally binding standards (collectively referred to as "laws and regulations"). In case of violation, this product's services will be terminated at any time, and all responsibilities must be borne by the user.

Antscore API#

HTTP Protocol#

Request Parameters#

Response Structure#

websocket#

WSConnection Parameters#

Global Response Structure#

Account and Key##

SDK-Demo#

Usage Restrictions#

Integration Restrictions#

Request Rate Limits#

WebSocket Connection Limits#

Notes#