How users find listings, browse collections, view activity feeds, check ownership, and discover seller profiles. Cursor-based pagination and real-time price conversion.
The marketplace provides several discovery mechanisms for buyers and sellers.
The sellerProfile endpoint returns comprehensive seller data:
The stats endpoint returns a real-time network snapshot:
The activity endpoint supports filtered, paginated activity logs:
| Filter | Purpose |
|---|---|
kinds | Array of activity types (MINT, TRANSFER, LIST, BUY, SELL, etc.) |
chain | Filter to specific blockchain |
address | Filter to specific wallet |
collectionId | Filter to specific collection |
listingOutpoint | Filter to specific listing |
Activity uses keyset pagination on assetActivity.id (which is a sortable {epochMs}_{random} format). No OFFSET is used anywhere -- all pagination is cursor-based for consistent performance at any depth.
The ownedAssets endpoint detects chain from wallet address format and returns owned assets:
Results are served from assetOwnershipCache with optimistic responses (serve cached data immediately, verify on-chain in the background). Stale entries are tracked by verifiedAt and refreshed periodically.
The nativeUsdRates endpoint provides current BTC/ETH/SOL to USD exchange rates for converting priceSats to display currencies in the UI.
All list queries use cursor-based (keyset) pagination:
WHERE id < ?cursor ORDER BY id DESC LIMIT ?pageSizeThis avoids the performance degradation of OFFSET-based pagination on large tables. Cursors are opaque strings (the id field) passed back to the client for the next page.
The system distinguishes between indexed and unindexed listings:
This allows soft-removal of content through moderation without deleting data.