CO Private Data

Realtime

This interface serves as the unified entry point for Cryptoracle's indicator data retrieval. It supports fetching multiple indicators through a single request, allowing the input of common parameters such as multiple tokens and time ranges. It is suitable for batch query scenarios, reducing the overhead of multiple API calls.

Important Notes:

• Data latency: 10 minutes;

• Data start time: January 1, 2025;

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

• 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;

• If additional parameters are required for a specific indicator, please include them in the extraParams field according to the specified structure;

• Please ensure the indicator codes in the endpoints array are accurate, as incorrect codes may cause request failures or return empty data;

• This interface is designed to enhance flexibility and efficiency when making calls in multi-indicator and multi-token scenarios.

Request URL

http

POST /v2.1/endpoint

Request Parameters

Parameter	Type	Required	Description
token	List	Yes	List of token names, e.g. ["BTC","ETH"]
startTime	string	Yes	Start time in format yyyy-MM-dd HH:mm:ss
endTime	string	Yes	End time in format yyyy-MM-dd HH:mm:ss
timeType	string	Yes	Time granularity. Options: 15m (15 minutes), 1h (1 hour), 4h (4 hours), 1d (1 day)
endpoints	List	Yes	List of indicators, e.g. ["CO-A-01-01","CO-A-01-02"]
tags	List	No	List of tags, e.g. ["CO-B-03-01","CO-B-03-05"]
extraParams	List	No	Additional parameters for specific indicators

Extended Parameter Structure (for extraParams)

Parameter	Type	Required	Description
endpoint	String	No	Target indicator ID, e.g. CO-A-01-01
param	Object	No	Extended parameters for the indicator

Response Parameters

Parameter	Type	Description
token	string	Token name
startTime	string	Start time
endTime	string	End time
timeType	string	Time granularity (same as request)
timePeriods	List	List of time periods

Time Period Structure

Parameter	Type	Description
startTime	string	Period start time (yyyy-MM-dd HH:mm:ss)
endTime	string	Period end time (yyyy-MM-dd HH:mm:ss)
data	List	Indicator data, e.g. [{"endpoint": "CO-A-01-01","value": "1"},{"endpoint": "CO-A-01-02","value": "1.22"}]

Request Example

json

{
    "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": {
                "val": "123"
            }
        }
    ],
    "timeType": "1d",
    "token": [
        "BTC",
        "ETH"
    ]
}

Response Example

json

[
    {
        "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"
                    }
                ]
            }
        ]
    }
]