Highlight APIhighlight.xyz ↗

"""Walkthrough: Highlight.xyz NFT Collections SDK — discover trending mints and analyze collections."""
from parse_apis.Highlight_xyz_NFT_Collections_API import Highlight, CollectionNotFound

client = Highlight()

# Fetch trending collections from the last week, capped at 5 total items.
for col in client.collection_summaries.trending(period_hours=168, limit=5):
    print(col.name, col.chainName, col.mintsCount, "mints")

# Drill into the top trending collection for full details.
top = client.collection_summaries.trending(limit=1).first()
if top:
    detail = top.details()
    print(detail.name, detail.standard, detail.collectionType, f"{detail.supply}/{detail.size}")

    # List the top collectors for this collection.
    for collector in detail.collectors.list(limit=3):
        print(collector.walletAddress, collector.ensName, collector.tokensCount, "tokens")

    # Explore sponsors on the first mint vector (if any).
    if detail.mintVectors:
        mv = detail.mintVectors[0]
        for sponsor in mv.sponsors.list(limit=3):
            print(sponsor.user.displayName, sponsor.totalNumSponsored, "sponsored")

# Search for a collection by keyword and explore related projects.
found = client.collection_summaries.search(query="generative", limit=1).first()
if found:
    for related in found.related_projects.list(limit=3):
        print(related.name, related.chainName, related.supply)

# Typed error handling: catch a not-found collection.
try:
    client.collections.get(collection_id="ethereum:0x0000000000000000000000000000000000000000")
except CollectionNotFound as exc:
    print(f"Collection not found: {exc.collection_id}")

print("exercised: trending / details / collectors.list / sponsors.list / search / related_projects.list / get")