# Crypto Movers API
> Live crypto top-gainers and top-losers as an API, powered by CoinGecko. Across the 1-hour, 24-hour and 7-day windows it ranks the biggest gainers and the biggest losers among the market-cap-leading coins, with each coin's price, percent move, market cap and 24-hour volume. Get the gainers board, the losers board, or both together for a given timeframe. A market-cap floor keeps the boards to coins with a real market cap, so the movers are meaningful rather than dust. The market-movers leaderboard for trading, screening and dashboard apps. Live, no key, no cache. Distinct from trending (most-searched) and from price and market-cap APIs — this is the performance gainers/losers board.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cryptomovers-api/..."
```

## Pricing
- **Free** (Free) — 7,000 calls/Mo, 5 req/s
- **Starter** ($13/Mo) — 95,000 calls/Mo, 15 req/s
- **Pro** ($34/Mo) — 480,000 calls/Mo, 40 req/s
- **Desk** ($80/Mo) — 2,500,000 calls/Mo, 100 req/s

## Endpoints

### Gainers

#### `GET /v1/gainers` — Top gainers over a window

**Parameters:**
- `period` (query, optional, string) — Window: 1h|24h|7d Example: `24h`
- `limit` (query, optional, string) — Max coins (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptomovers-api/v1/gainers?period=24h&limit=20"
```

**Response:**
```json
{
    "data": {
        "board": "gainers",
        "coins": [
            {
                "id": "ethgas-2",
                "name": "ETHGas",
                "rank": 124,
                "price": 0.166679,
                "symbol": "GWEI",
                "change_pct": 31.29,
                "market_cap": 349362044,
                "volume_24h": 31087950
            },
            {
                "id": "velvet",
                "name": "Velvet",
                "rank": 219,
                "price": 0.320261,
                "symbol": "VELVET",
                "change_pct": 24.59,
                "market_cap": 134613350,
                "volume_24h": 32231355
            },
            {
                "id": "audiera",
                "name": "Audiera",
                "rank": 61,
                "price": 4.25,
                "symbol": "BEAT",
                "change_pct": 21.48,
                "market_cap": 1219063823,
                "volume_24h": 61452791
            },
            {
                "id": "stasis-eurs",
                "name": "STASIS EURO",
                "rank": 204,
                "price": 1.22,
                "symbol": "EURS",
                "change_pct": 10.89,
                "market_cap": 151079997,
                "volume_24h": 3694.9
            },
            {
                "id": "banana-for-scale-2",
                "name": "Banana For Scale",
                "rank": 239,
                "price": 0.01154434,
                "symbol
…(truncated, see openapi.json for full schema)
```

### Losers

#### `GET /v1/losers` — Top losers over a window

**Parameters:**
- `period` (query, optional, string) — Window: 1h|24h|7d Example: `24h`
- `limit` (query, optional, string) — Max coins (1-100) Example: `20`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptomovers-api/v1/losers?period=24h&limit=20"
```

**Response:**
```json
{
    "data": {
        "board": "losers",
        "coins": [
            {
                "id": "humanity",
                "name": "Humanity",
                "rank": 170,
                "price": 0.11092,
                "symbol": "H",
                "change_pct": -84.54,
                "market_cap": 207570212,
                "volume_24h": 583614770
            },
            {
                "id": "bianrensheng",
                "name": "币安人生 (BinanceLife)",
                "rank": 85,
                "price": 0.724777,
                "symbol": "币安人生",
                "change_pct": -13.53,
                "market_cap": 724776779,
                "volume_24h": 50023047
            },
            {
                "id": "falcon-finance-ff",
                "name": "Falcon Finance",
                "rank": 154,
                "price": 0.08053,
                "symbol": "FF",
                "change_pct": -13.46,
                "market_cap": 231524664,
                "volume_24h": 9319421
            },
            {
                "id": "origintrail",
                "name": "OriginTrail",
                "rank": 203,
                "price": 0.342386,
                "symbol": "TRAC",
                "change_pct": -12.6,
                "market_cap": 151577373,
                "volume_24h": 9733227
            },
            {
                "id": "edgex",
                "name": "edgeX",
                "rank": 211,
                "price": 0.404
…(truncated, see openapi.json for full schema)
```

### Movers

#### `GET /v1/movers` — Top gainers and losers together

**Parameters:**
- `period` (query, optional, string) — Window: 1h|24h|7d Example: `24h`
- `limit` (query, optional, string) — Max each side (1-50) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptomovers-api/v1/movers?period=24h&limit=10"
```

**Response:**
```json
{
    "data": {
        "losers": [
            {
                "id": "humanity",
                "name": "Humanity",
                "rank": 170,
                "price": 0.11092,
                "symbol": "H",
                "change_pct": -84.54,
                "market_cap": 207570212,
                "volume_24h": 583614770
            },
            {
                "id": "bianrensheng",
                "name": "币安人生 (BinanceLife)",
                "rank": 85,
                "price": 0.724777,
                "symbol": "币安人生",
                "change_pct": -13.53,
                "market_cap": 724776779,
                "volume_24h": 50023047
            },
            {
                "id": "falcon-finance-ff",
                "name": "Falcon Finance",
                "rank": 154,
                "price": 0.08053,
                "symbol": "FF",
                "change_pct": -13.46,
                "market_cap": 231524664,
                "volume_24h": 9319421
            },
            {
                "id": "origintrail",
                "name": "OriginTrail",
                "rank": 203,
                "price": 0.342386,
                "symbol": "TRAC",
                "change_pct": -12.6,
                "market_cap": 151577373,
                "volume_24h": 9733227
            },
            {
                "id": "edgex",
                "name": "edgeX",
                "rank": 211,
                "price": 0.404668,
                "symb
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cryptomovers-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "CoinGecko public markets (live)",
        "periods": [
            "1h",
            "24h",
            "7d"
        ],
        "service": "cryptomovers-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/losers": "Top losers over a window (period=1h|24h|7d, limit).",
            "GET /v1/movers": "Top gainers and losers together (period=24h, limit each).",
            "GET /v1/gainers": "Top gainers over a window (period=1h|24h|7d, limit)."
        },
        "description": "Live crypto top-gainers and top-losers from CoinGecko: across the 1h, 24h and 7d windows, the biggest gainers and losers among the market-cap-leading coins, each with price, percent move, market cap and 24h volume. Get the gainers board, the losers board, or both. A junk filter keeps to coins with a real market cap. Live, no key. Distinct from trending (most-searched) and price/market-cap APIs — this is the performance gainers/losers leaderboard.",
        "universe_size": 250,
        "min_market_cap_usd": 10000000
    },
    "meta": {
        "timestamp": "2026-06-09T03:02:13.548Z",
        "request_id": "dcd3c256-6488-42b8-9568-b207d3853dee"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/cryptomovers-api
OpenAPI spec: https://www.oanor.com/api/cryptomovers-api/openapi.json
