Queries
Sort Query Results
Learn how to sort query results using the order argument.
Sort Query Results
The order argument organizes results based on specified values. Sort direction options include ascending (asc) or descending (desc), using the format {field_name: order}. Execution sequence determines prioritization — earlier values take precedence.
Basic Sorting
{
assets(order: { isLaunched: desc, name: asc }, limit: 10) {
name
symbol
slug
isLaunched
}
}This demonstrates sorting assets alphabetically by name, with launched assets appearing first.
Advanced Sorting with Metrics
Ordering supports changePercentagesKey or changeAbsolutesKey combined with metricKey_asc or metricKey_desc, where direction derives from metricKey.
{
assets(
order: { metricKey_desc: "staking_marketcap", changePercentagesKey: _30d }
limit: 10
) {
id
name
slug
description
symbol
metrics(where: { metricKeys: ["staking_marketcap"] }, limit: 10) {
metricKey
defaultValue
changePercentages
}
}
}This demonstrates ranking the top 10 assets by staking marketcap using 30-day percentage changes.
Sort Options
| Field | Description |
|---|---|
metricKey_asc | Sort by metric value ascending |
metricKey_desc | Sort by metric value descending |
changePercentagesKey | Sort by percentage change over a period |
changeAbsolutesKey | Sort by absolute change over a period |
name | Sort alphabetically by name |
address | Sort by address (validators) |
createdAt | Sort by creation date |
Time Periods for Change Sorting
When using changePercentagesKey or changeAbsolutesKey:
_24h— 24 hours_7d— 7 days_30d— 30 days_90d— 90 days_1y— 1 year