---
title: "Query account statistics and activity"
method: GET
path: "/v1/accounts"
tags: ["Accounts"]
---

# Query account statistics and activity

`GET /v1/accounts`

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.

## Query parameters

- `first` number
- `skip` number
- `sortBy` 'most_sales' | 'most_purchases' | 'most_royalties' | 'most_collections' | 'most_earned' | 'most_spent'
- `id` string
- `address` string[]
- `network` 'ETHEREUM' | 'MATIC'

## Response `200`

Account statistics

- object
  - `data` object[], required
    - `id` string, required — Account identifier
    - `address` string, required — Wallet address of the account
    - `sales` number, required — Total number of items sold
    - `purchases` number, required — Total number of items purchased
    - `spent` string, required — Total amount spent in Wei (as string to handle large numbers)
    - `earned` string, required — Total amount earned from sales in Wei
    - `royalties` string, required — Total royalties earned in Wei
    - `collections` number, required — Number of collections created
  - `total` number, required — Total number of accounts matching the filters

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)