agorix
AirdropMarketsCollectionsLeaderboardActivity
Agorix · Decentralized Marketplace
Independent · Resilient · Community-Run

A cross-chain marketplace, run by the community.

Discover, list, and trade across Bitcoin, Ethereum, and Solana on an open, community-run network.

Marketplace
CollectionsMarketsLeaderboardActivity
Network
GovernanceExplorerAirdropDocs
Account
ProfileSettings
Legal
Terms of ServicePrivacy PolicyYour Privacy Choices
agorix.io — Lasting Access
CID: 0xA60R1X · v0.1
AirdropMarketsCollections
D
Protocol Docs
Marketplace OverviewAtomic Buy LocksDatabase ArchitectureProfiles & AuthenticationCollections & RoyaltiesCreator Royalty SystemMedia Cache & OptimizationModeration & ReputationSearch & DiscoveryCollection Rarity AlgorithmsLive Activity & LeaderboardsCollection Preseed Queue
Docs/Marketplace/Search & Discovery
Marketplace

Search & Discovery

How users find listings, browse collections, view activity feeds, check ownership, and discover seller profiles. Cursor-based pagination and real-time price conversion.

#Search & Discovery

The marketplace provides several discovery mechanisms for buyers and sellers.

#Seller Profiles

The sellerProfile endpoint returns comprehensive seller data:

  • Listings: All listings by this seller, paginated and ordered by creation date
  • Stats: Open count, sold count, delisted count
  • Volume: Total listed volume and total sold volume per chain
  • Top Collections: Most frequently listed collections with per-collection stats

#Global Statistics

The stats endpoint returns a real-time network snapshot:

  • Total listings across all chains
  • Total completed orders
  • Total protocol events processed
  • Currently open listing count

#Activity Feeds

The activity endpoint supports filtered, paginated activity logs:

FilterPurpose
kindsArray of activity types (MINT, TRANSFER, LIST, BUY, SELL, etc.)
chainFilter to specific blockchain
addressFilter to specific wallet
collectionIdFilter to specific collection
listingOutpointFilter 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.

#Ownership Discovery

The ownedAssets endpoint detects chain from wallet address format and returns owned assets:

  • Bitcoin: Ordinals via inscription cache lookups
  • EVM: NFTs via on-chain contract queries (ERC-721/ERC-1155)
  • Solana: SPL tokens via account enumeration

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.

#Price Conversion

The nativeUsdRates endpoint provides current BTC/ETH/SOL to USD exchange rates for converting priceSats to display currencies in the UI.

#Pagination Strategy

All list queries use cursor-based (keyset) pagination:

text
WHERE id < ?cursor ORDER BY id DESC LIMIT ?pageSize

This 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.

#Indexed vs Unindexed Listings

The system distinguishes between indexed and unindexed listings:

  • Indexed: Displayed in search, counted in stats -- status is OPEN and not admin-flagged
  • Unindexed: Hidden from search -- used for admin/test/moderated listings

This allows soft-removal of content through moderation without deleting data.

PreviousModeration & ReputationNext Collection Rarity Algorithms

On this page

  • Search & Discovery
  • Seller Profiles
  • Global Statistics
  • Activity Feeds
  • Ownership Discovery
  • Price Conversion
  • Pagination Strategy
  • Indexed vs Unindexed Listings