Query: movers

Top gainers and losers by price change

movers

Top gainers or losers ranked by price change percentage over a given time period. Computes actual price change from historical snapshots.

Signature

graphql
movers(period: Period! = H24, direction: Direction! = UP, limit: Int = 20): TokenList!

Arguments

Argument	Type	Default	Description
`period`	Period	H24	Evaluation timeframe: `H1`, `H6`, `H24`, `D7`
`direction`	Direction	UP	`UP` for top gainers, `DOWN` for top losers
`limit`	Int	20	Number of tokens to return (max 100)

Complexity

Base cost: 5 units

Example — Top gainers

graphql
query GetTopGainers {
  movers(period: H24, direction: UP, limit: 10) {
    tokens {
      symbol
      address
      price { usd change24h }
      liquidity { usd }
    }
  }
}

Example — Top losers

graphql
query GetTopLosers {
  movers(period: H24, direction: DOWN, limit: 10) {
    tokens {
      symbol
      price { usd change24h }
    }
  }
}