latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Accounts

Query account statistics and activity

Retrieves accounts with their marketplace activity statistics including sales, purchases, earnings, spending, royalties, and collection counts.

Supports filtering and sorting by various metrics:

  • Most sales, purchases, collections created
  • Highest earnings, spending, or royalties earned
  • Specific accounts by address or ID
  • Network filtering (Ethereum, Polygon)

Use this endpoint to:

  • Display marketplace leaderboards
  • Track user trading statistics
  • Analyze account activity and performance
  • Identify top sellers, buyers, and creators

Results are paginated and can be sorted by different ranking criteria.

get/v1/accounts

Query parameters

firstnumber

Maximum number of accounts to return (default: 100, max: 1000)

skipnumber

Number of accounts to skip for pagination (default: 0)

sortBy'most_sales' | 'most_purchases' | 'most_royalties' | 'most_collections' | 'most_earned' | 'most_spent'

Sort accounts by specific metrics:

  • most_sales: Accounts with most items sold
  • most_purchases: Accounts with most items purchased
  • most_royalties: Accounts earning most royalties
  • most_collections: Accounts with most collections created
  • most_earned: Accounts with highest total earnings
  • most_spent: Accounts with highest total spending
idstring

Filter by specific account ID

addressstring[]

Filter by one or more account addresses (can be repeated or comma-separated)

network'ETHEREUM' | 'MATIC'

Filter by network

Response

Account statistics

totalnumber required

Total number of accounts matching the filters