Get listing chart by collection

get

https://data-api.nftgo.io/eth/v1/collection/{collection}/chart/listing

Return the number of listings chart data on a given time range, including a series of value x and value y. x is a timestamp in second and y is the number of listings in corresponding time.

If (now - end_time <= 5 minutes) and (end_time - start_time <= 6 hours), the interval between two time points will be 5 minutes, otherwise the interval will be 1 hour

Path Params

collection

string

required

The collection filter can be a contract address, collection id, slug or opensea slug.If the slug contains special characters, you need to escape them before performing the query.

Query Params

start_time

date-time

Defaults to 2022-08-20T00:00:00+00:00

Queries can be bounded by a Start Time and End Time. Start Time is the earliest timestamp to include in the transaction query, formatted as an UTC timestamp in seconds or ISO 8601 format date time string, such as 2022-08-20T00:00:00+00:00. Start Time limited to 2021-09-01T00:00:00+00:00 or later.

end_time

date-time

Defaults to 2022-09-01T00:00:00+00:00

Where an End Time is specified, transaction queries will fetch all transactions up to but excluding the End Time, which is formatted as an UTC timestamp in seconds or ISO 8601 format date time string. The query window varies according to the plan.

interval_multiplier

integer

≥ 1

Defaults to 1

Customizable interval, must be a multiple of the minimum granularity. If the time span for requesting data is less than 6 hours, the granularity of the interval is 5 minutes. If the time span for requesting data is more than 6 hours, the granularity of the interval is 1 hour.

For example, if the time span for your request is 3 hours, and you want the data with 10-minute intervals. Then you need to input 2 (10/5=2) into this parameter. Because the granularity for the 3-hour time span is 5 minutes.

Responses

200Successful Response

422Validation Error