Asset Buckets

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.

Bucket Construction

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:

1GrailThe highest valued assets within the collection at that point in time
2MidThe median valued assets within the collection at that point in time
3FloorThe lowest valued assets within the collection at that point in time

Identifying Buckets

Every bucket is uniquely identifiable. Each bucket can be identified using a unique key in the format <collection_id>-<method>-<granularity>-<level>.

Bucket Evolution

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.

Retrieving the 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.

Asset Bucket Proofs

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.