---
title: "Market-wide top gainers/losers with volume filter, in one call"
method: GET
path: "/agentFriendly/top_movers"
tags: ["AgentFriendly"]
---

# Market-wide top gainers/losers with volume filter, in one call

`GET /agentFriendly/top_movers`

Returns the top gaining or losing assets over the last 24h in a single call — use this for movers/screening queries instead of looping per-asset history. Filter thin markets with minVolumeUsd24Hr. Window is 24h (for intraday detail follow up with /agentFriendly/ta/candlesticks_batch on the returned slugs).

## Query parameters

- `direction` 'gainers' | 'losers'
- `limit` integer
- `minVolumeUsd24Hr` number
- `topN` integer

## Response `200`

Ranked movers

- object
  - `timestamp` integer
  - `direction` string
  - `window` string
  - `data` object[]
    - `slug` string
    - `symbol` string
    - `name` string
    - `priceUsd` string
    - `changePercent24Hr` string, nullable
    - `volumeUsd24Hr` string
    - `marketCapUsd` string

## Other responses

- `400` — Bad request - invalid parameters
- `402` — Payment Required
- `500` — Internal server error

---

[API](https://skmtc.dev/coincap/apis/coincap-api.md) · [All operations](https://skmtc.dev/coincap/apis/coincap-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coincap/coincap-api/revisions/e3d3739c2c03/schema)