API List

CO Real-Time Data

This endpoint serves as Cryptoracle's unified entry point for retrieving indicator data. It supports fetching multiple indicators in a single request, allowing you to specify common parameters such as multiple tokens and a time range. It is suitable for batch query scenarios to reduce the overhead of multiple API calls.

Important Notes

• Data Delay: 15 minutes.

• Data Start Time: January 1, 2025.

• Time Format: All time fields must use the current time (UTC+8, Beijing Time) in the format: YYYY-MM-DD HH:mm:ss.

• Batch Queries: Multiple tokens and multiple indicators can be requested in a single call to improve query efficiency. A single API request can return a maximum of 2,000 records.

• Extra Parameters: If a specific indicator requires additional parameters, please pass them within the extraParams object according to the specified structure.

• Endpoint Codes: Please ensure the indicator codes in the endpoints array are accurate. Incorrect codes may lead to request failures or empty data returns.

• Purpose: This interface is designed to enhance flexibility and efficiency when querying data across multiple indicators and tokens.

---

Request URL

POST

/v2/endpoint

---

Common Request Parameters

Parameter	Type	Required	Description
token	List	Yes	List of token symbols (e.g., ["BTC", "ETH"])
startTime	String	Yes	Start time in UTC, format: yyyy-MM-dd HH:mm:ss
endTime	String	Yes	End time in UTC, format: yyyy-MM-dd HH:mm:ss
timeType	String	Yes	Time granularity: 15m (15 minutes), 1h (1 hour), 4h (4 hours), 1d (1 day)
endpoints	List	Yes	Metric codes to be queried (e.g., ["CO-A-01-01", "CO-A-01-02"])
tags	List	No	Optional tags (e.g., ["CO-B-03-01", "CO-B-03-05"])
extraParams	List	No	Optional list of extra parameters (see each metric’s definition for details)

---

Structure for extraParams

Parameter	Type	Required	Description
endpoint	String	No	The specific metric ID the parameters apply to (e.g., CO-A-01-01)
param	Object	No	The extended parameter object for the metric (refer to metric definitions)

---

Response Parameters

Parameter	Type	Description
token	String	Token name
startTime	String	Start time in UTC
endTime	String	End time in UTC
timeType	String	Time granularity (matches request)
endPoints	List	List of returned metrics
tags	List	List of returned tags

---

Metric Data Structure

Parameter	Type	Description
startTime	String	Start time in UTC
endTime	String	End time in UTC
data	List	Metric values in the format:
		[{"endpoint": "CO-A-01-01", "value": "1"}, {"endpoint": "CO-A-01-02", "value": "1.22"}]

---

Example (Pre-encryption Business Request Parameters)

{
        "endpoints": [
                "CO-A-01-01",
                "CO-A-01-02"
        ],
        "startTime": "2025-05-01 00:00:00",
        "endTime": "2025-05-01 23:59:59",
        "extraParams": [
                {
                        "endpoint": "CO-A-01-01",
                        "param": {
                                "a": "123",
                                "b": "456"
                        }
                }
        ],
        "timeType": "1d",
        "token": [
                "BTC",
                "ETH"
        ]
}

Example of Decrypted data Field in Response

[
        {
                "token": "BTC",
                "startTime": "2025-05-01 00:00:00",
                "endTime": "2025-05-02 23:59:59",
                "timeType": "1d",
                "timePeriods": [
                        {
                                "startTime": "2025-05-02 08:00:00",
                                "endTime": "2025-05-03 07:59:59",
                                "data": [
                                        {
                                                "endpoint": "CO-A-01-01",
                                                "value": "1"
                                        },
                                        {
                                                "endpoint": "CO-A-01-02",
                                                "value": "1.22"
                                        }
                                ]
                        },
                        {
                                "startTime": "2025-05-01 08:00:00",
                                "endTime": "2025-05-02 07:59:59",
                                "data": [
                                        {
                                                "endpoint": "CO-A-01-01",
                                                "value": "1"
                                        },
                                        {
                                                "endpoint": "CO-A-01-02",
                                                "value": "1.00"
                                        }
                                ]
                        }
                ]
        },
        {
                "token": "ETH",
                "startTime": "2025-05-01 00:00:00",
                "endTime": "2025-05-02 23:59:59",
                "timeType": "1d",
                "timePeriods": [
                        {
                                "startTime": "2025-05-02 08:00:00",
                                "endTime": "2025-05-03 07:59:59",
                                "data": [
                                        {
                                                "endpoint": "CO-A-01-01",
                                                "value": "3"
                                        },
                                        {
                                                "endpoint": "CO-A-01-02",
                                                "value": "1.00"
                                        }
                                ]
                        },
                        {
                                "startTime": "2025-05-01 08:00:00",
                                "endTime": "2025-05-02 07:59:59",
                                "data": [
                                        {
                                                "endpoint": "CO-A-01-01",
                                                "value": "3"
                                        },
                                        {
                                                "endpoint": "CO-A-01-02",
                                                "value": "1.00"
                                        }
                                ]
                        }
                ]
        }
]

Token List

Returns the list of tokens supported by the system.

Request URL

text

POST /v2/coin/list

Request Data

Parameter Name	Type	Required	Description
timeType	string	No	Can pass multiple values, separated by commas (e.g., 15m,1h). The time granularity. Optional values are 15m (15 minutes), 1h (1 hour), 4h (4 hours), 1d (1 day). Used to retrieve the supported tokens for specific granularities.

Response Data

{
    "data": {
        "total": 2,
        "list": [
            {
                "coin": "BTC",
                "name": "Bitcoin"
            },
            {
                "coin": "ETH",
                "name": "Ethereum"
            }
        ]
    },
    "code": 200,
    "msg": "success"
}