Asset buckets provide a structured approach to categorizing assets according to their market valuation. Each bucket represents a group of assets sharing similar valuation characteristics within a specific range.
To construct the buckets, each collection's assets are sorted in descending order based on their valuation for a specific point in time. From this sorted list, assets are then categorized into three distinct buckets:
|1||Grail||The highest valued assets within the collection at that point in time|
|2||Mid||The median valued assets within the collection at that point in time|
|3||Floor||The lowest valued assets within the collection at that point in time|
Every bucket is uniquely identifiable. Each bucket can be identified using a unique key in the format
As market dynamics shift and the valuation of assets fluctuates, the assets within each bucket might change. To keep track of these changes, "snapshots" are taken. Each snapshot captures the state of the buckets at a specific point in time. Each snapshot can be identified by a combination of the collection id and a Merkle root.
The Merkle root for each snapshot can be obtained by using the Bucket Snapshot Search endpoint. Users can input the collection_id and other optional parameters to retrieve the corresponding Merkle root.
To ensure the integrity and authenticity of the assets within each bucket, Merkle proofs are employed. Users can obtain these proofs via the Get Asset Bucket Proofs endpoint. This provides a cryptographic verification mechanism, ensuring that an asset belongs to the specified bucket.
Updated 22 days ago