Staking Data
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

FieldDescription
metricKey_ascSort by metric value ascending
metricKey_descSort by metric value descending
changePercentagesKeySort by percentage change over a period
changeAbsolutesKeySort by absolute change over a period
nameSort alphabetically by name
addressSort by address (validators)
createdAtSort 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

On this page