Query Modes

Mode 1: Pagination (Entity Lists)

Applicable to trading pairs, institution lists, news feeds, and other non-time-series data. The following parameters are common to all endpoints marked as paginated and will not be repeated per endpoint.

Parameter	Type	Required	Default	Description
page	integer	No	1	Page number, starting from 1
page_size	integer	No	20	Items per page, max 100

Paginated response structure:

{
    "list": [ ... ],
    "page": 1,
    "page_size": 20,
    "total": 542
}

Mode 2: Time Window (Time-Series Data)

Applicable to klines, ETF historical net inflow data, and other time-series data. The following parameters are common to all endpoints marked as time window and will not be repeated per endpoint.

Parameter	Type	Required	Description
start_time	long	No	Start time, millisecond Unix timestamp
end_time	long	No	End time, millisecond Unix timestamp
limit	integer	No	Maximum number of records returned (see each endpoint for its max value)

• Data is returned in ascending chronological order. If the number of records in the time range exceeds limit, the earliest limit records are returned.

• Pagination: Use timestamp + 1 from the last record of the previous response as start_time for the next request.

• When neither start_time nor end_time is provided, the most recent limit records are returned by default.

Endpoint-specific availability

Data Type	Availability
Klines	Only 1d interval is supported. Query range is limited to the most recent 3 months.
ETF historical net inflow	Query range is limited to the most recent 1 month.
Feeds time filters	start_time and end_time only support the most recent 7 days.

Time-series response structure:

[
    { ... }
]

General Conventions

• All timestamp fields are UTC millisecond Unix timestamps (e.g. 1710000000000)

• All monetary fields are denominated in USD by default

• All field names follow snake_case convention