Get Detailed NFT Stats

Endpoint: getDetailedNftStats

Method: POST

Arguments

Name	Type	Description
bucketCount	Int	The number of aggregated values to receive. Note: Each duration has predetermined bucket sizes. The first n-1 buckets are historical. The last bucket is a snapshot of current data. duration `day1`: 6 buckets (4 hours each) plus 1 partial bucket duration `hour12`: 12 buckets (1 hour each) plus 1 partial bucket duration `hour4`: 8 buckets (30 min each) plus 1 partial bucket duration `hour1`: 12 buckets (5 min each) plus 1 partial bucket duration `min5`: 5 buckets (1 min each) plus 1 partial bucket For example, requesting 11 buckets for a `min5` duration will return the last 10 minutes worth of data plus a snapshot for the current minute.
collectionAddress	String!	The contract address of the NFT collection. Required
durations	[DetailedNftStatsDuration]	The list of durations to get detailed pair stats for.
grouping	String	The marketplace address to filter by. Can be used to get marketplace-specific metrics, otherwise uses all.
networkId	Int!	The network ID the NFT collection is deployed on. Required
timestamp	Int	The unix timestamp for the stats. Defaults to current.

Response

DetailedNftStats

Name	Type	Description
collectionAddress	String!	The contract address of the NFT collection.
grouping	String	The marketplace address or `all`. Can be used to get marketplace-specific metrics.
networkId	Int!	The network ID the NFT collection is deployed on.
stats_day1	WindowedDetailedNftStats	The breakdown of stats over a 24 hour window.
stats_day30	WindowedDetailedNftStats	The breakdown of stats over a 30 day window.
stats_hour1	WindowedDetailedNftStats	The breakdown of stats over an hour window.
stats_hour4	WindowedDetailedNftStats	The breakdown of stats over a 4 hour window.
stats_hour12	WindowedDetailedNftStats	The breakdown of stats over a 12 hour window.
stats_week1	WindowedDetailedNftStats	The breakdown of stats over a 7 day window.

Picking Duration

The duration chosen as input for the query will be used in the following ways:

Provides the currentValue, previousValue, and percent change between the two.
Determines the bucket size and default bucketCount (the number of buckets per window) that will be returned.

Buckets Explained

Duration	Bucket Size	Default `bucketCount`
5 minutes	1 minute	5 + 1 = 6
15 minutes	1 minute	15 + 1 = 16
1 hour	5 minutes	12 + 1 = 13
4 hours	30 minutes	8 + 1 = 9
12 hours	1 hour	12 + 1 = 13
1 day	4 hours	6 + 1 = 7
1 week	12 hours	14 + 1 = 15
30 days	1 day	30 + 1 = 31

Bucket sizes are predetermined for each duration. The first n-1 buckets are always historical, while the last bucket is a snapshot of current data. Defaults for bucketCount are displayed above, but can be overridden by query input to receive more or less aggregated values.

For example, requesting a min5 duration with a bucketCount of 11 at 12:00:30PM will return

aggregated stats and the percent change between
- the most current 5 minute window (11:55AM-12:00PM),
- the previous 5 minute window (11:50AM-11:55AM).
10 completed aggregated stats for each minute over those 10 minutes (11:50AM-11:51AM ... 11:59AM-12:00PM) plus 1 partial snapshot of stats for the current minute (12:00:00PM-12:00:30PM).
- the first 5 stats will add up to the previousValue,
- the second 5 stats will add up to the currentValue.

Explore

👋
Join our Discord
Ask questions, share what you're working on and request new features