---
title: "Top gainers/losers"
method: GET
path: "/api/v1/global-stats/movers"
tags: ["market"]
---

# Top gainers/losers

`GET /api/v1/global-stats/movers`

## Request

- Base URL: `https://api.bitcompare.net`
- URL: `https://api.bitcompare.net/api/v1/global-stats/movers`
- Auth: one of:
  - none
  - HTTP bearer

Biggest 24h gainers and losers within a rank segment.

## Query parameters

- `segment` 'top10' | 'top100' | 'top1000'
- `limit` integer

## Response `200`

Successful response

- object
  - `gainers` object[], required: Top 24h gainers in the requested segment
    - `id` string, required: Canonical coin ID (e.g. `bitcoin`)
    - `symbol` string, required: Trading symbol (e.g. `btc`)
    - `name` string, required: Human-readable name (e.g. `Bitcoin`)
    - `marketCap` number: Market cap in USD
    - `rank` integer: Market cap rank (1 = largest)
    - `price` number: Current spot price in USD
  - `losers` object[], required: Top 24h losers in the requested segment
    - `id` string, required: Canonical coin ID (e.g. `bitcoin`)
    - `symbol` string, required: Trading symbol (e.g. `btc`)
    - `name` string, required: Human-readable name (e.g. `Bitcoin`)
    - `marketCap` number: Market cap in USD
    - `rank` integer: Market cap rank (1 = largest)
    - `price` number: Current spot price in USD

## Other responses

- `401`: Missing or invalid API key
- `429`: Plan rate limit exceeded — see X-RateLimit-* headers and Retry-After

---

[API](https://skmtc.dev/bitcompare/apis/bitcompare-api.md) · [All operations](https://skmtc.dev/bitcompare/apis/bitcompare-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitcompare/apis/bitcompare-api/revisions/936dfbf752d2?raw)