# Top Movers (`market_top_movers`)

> The day's ranked gainers and losers, plus the quieter names already trending more than five percent.

- Category: Market data
- MCP tool: `market_top_movers`
- REST: `GET /market/movers`
- x402 price: $0.01 per call (USDC on Base)
- HTML: https://www.f1ow.com/docs/tools/market_top_movers

## What it does

Ranked 24h gainers, losers, and trend candidates (>+5% move)

## Parameters

None.

## Call it

### cURL

```bash
curl "https://mcp.f1ow.com/v1/market/movers" \
  -H "Authorization: Bearer $F1OW_API_KEY"
```

### MCP

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "market_top_movers",
    "arguments": {}
  }
}
```

### TypeScript

```ts
const res = await fetch("https://mcp.f1ow.com/v1/market/movers", {
  headers: { Authorization: `Bearer ${process.env.F1OW_API_KEY}` },
});
const data = await res.json(); // the tool's result as JSON, typed in the OpenAPI spec
console.log(data);
```

### Python

```python
import os, requests

res = requests.get(
    "https://mcp.f1ow.com/v1/market/movers",
    headers={"Authorization": f"Bearer {os.environ['F1OW_API_KEY']}"},
)
data = res.json()  # the tool's result as JSON, typed in the OpenAPI spec
print(data)
```

### WebSocket

```jsonc
// wss://mcp.f1ow.com/v1/ws — subprotocol "jsonrpc-2.0", Authorization: Bearer <key>
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "market_top_movers",
    "arguments": {}
  }
}

// Or push a fresh result whenever it changes (minimum interval 15 s)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "subscriptions/subscribe",
  "params": {
    "name": "market_top_movers",
    "arguments": {},
    "intervalSeconds": 60
  }
}
```

### x402

```bash
# No account: the first call answers 402 with a PAYMENT-REQUIRED challenge;
# an x402 client pays it in USDC on Base and retries.
curl "https://mcp.f1ow.com/x402/v1/market/movers"
```

## Sample response

Captured 2026-11-13. The JSON is what REST and WebSocket return and the `structuredContent` of an MCP call (trimmed):

```json
{
  "gainers": [
    {
      "change24hPct": 219998.182919569,
      "marketCapRank": 269,
      "marketCapUsd": 84916162.9650324,
      "name": "MowCat",
      "priceUsd": 0.0849161629650324,
      "symbol": "MOW"
    },
    {
      "change24hPct": 92.050102991872,
      "marketCapRank": 255,
      "marketCapUsd": 107874780.023218,
      "name": "AKEDO",
      "priceUsd": 0.0047321283115959,
      "symbol": "AKE"
    },
    {
      "change24hPct": 66.211269830056,
      "marketCapRank": 327,
      "marketCapUsd": 54280141.6882419,
      "name": "Lombard",
      "priceUsd": 0.13687663782693,
      "symbol": "BARD"
    },
    {
      "change24hPct": 18.829105136573,
      "marketCapRank": 259,
      "marketCapUsd": 100291395.746346,
      "name": "Magma Finance",
      "priceUsd": 0.326815138888298,
      "symbol": "MAGMA"
    },
    {
      "change24hPct": 12.931017185835,
      "marketCapRank": 516,
      "marketCapUsd": 26004543.3306826,
      "name": "Osmosis",
      "priceUsd": 0.0375451632551988,
      "symbol": "OSMO"
    },
    {
      "change24hPct": 15.743904349677,
      "marketCapRank": 522,
      "marketCapUsd": 26699953.2275724,
      "name": "DODO",
      "priceUsd": 0.0266999532275724,
      "symbol": "DODO"
    },
    "… 4 more"
  ],
  "losers": [
    {
      "change24hPct": -41.198829794126,
      "marketCapRank": 577,
      "marketCapUsd": 22744456.1486829,
      "name": "Janction",
      "priceUsd": 0.00219965726794725,
      "symbol": "JCT"
    },
    {
      "change24hPct": -26.851297151804,
      "marketCapRank": 232,
      "marketCapUsd": 175818306.38763,
      "name": "Alaya Governance Token",
      "priceUsd": 0.0539334465980739,
      "symbol": "AGT"
    },
    {
      "change24hPct": -23.833145695725,
      "marketCapRank": 361,
      "marketCapUsd": 45993649.8351254,
      "name": "Bulla",
      "priceUsd": 0.0459936498351254,
      "symbol": "BULLA"
    },
    {
      "change24hPct": -23.13320650814,
      "marketCapRank": 678,
      "marketCapUsd": 17566257.7300614,
      "name": "Catecoin (cate.meme)",
      "priceUsd": 0.0182191320841393,
      "symbol": "CATE"
    },
    {
      "change24hPct": -18.429294851786,
      "marketCapRank": 553,
      "marketCapUsd": 25002951.445915,
      "name": "Orbio.so",
      "priceUsd": 0.0263188989257997,
      "symbol": "ORBIO"
    },
    {
      "change24hPct": -17.856995475676,
      "marketCapRank": 638,
      "marketCapUsd": 19379607.3333289,
      "name": "Unitas",
      "priceUsd": 0.13273703652965,
      "symbol": "UP"
    },
    "… 4 more"
  ],
  "trendCandidates": [
    "MOW",
    "AKE",
    "BARD",
    "MAGMA",
    "OSMO",
    "DODO",
    "… 4 more"
  ],
  "generatedAt": "2026-11-13T08:05:39.4856886+00:00"
}
```

Over MCP the text report a model reads comes with it:

```text
=== Top Gainers (24h) ===
#1   MOW     MowCat                     $0.08492  +219998.18%  mcap $84.92M
#2   AKE     AKEDO                     $0.004732    +92.05%  mcap $107.87M
#3   BARD    Lombard                     $0.1369    +66.21%  mcap $54.28M
#4   MAGMA   Magma Finance               $0.3268    +18.83%  mcap $100.29M
#5   OSMO    Osmosis                    $0.03755    +12.93%  mcap $26.00M
#6   DODO    DODO                       $0.02670    +15.74%  mcap $26.70M
#7   ARIA    AriaAI                      $0.2172    +11.14%  mcap $95.56M
#8   DNA     NeoSoul                     $0.1780    +13.64%  mcap $16.02M
#9   HUMA    Huma Finance              $0.008419    +12.72%  mcap $29.84M
#10  XPR     XPR Network               $0.001877    +11.74%  mcap $57.10M

=== Top Losers (24h) ===
#1   JCT     Janction                  $0.002200    -41.20%  mcap $22.74M
#2   AGT     Alaya Governance Token     $0.05393    -26.85%  mcap $175.82M
#3   BULLA   Bulla                      $0.04599    -23.83%  mcap $45.99M
#4   CATE    Catecoin (cate.meme)       $0.01822    -23.13%  mcap $17.57M
#5   ORBIO   Orbio.so                   $0.02632    -18.43%  mcap $25.00M
#6   UP      Unitas                      $0.1327    -17.86%  mcap $19.38M
#7   NBISB   Nebius Tokenized bStocks    $125.8894    -16.84%  mcap $12.76M
#8   HOOKR   Hookr.fun                  $0.01967    -15.98%  mcap $19.67M
#9   BANANAS31 Banana For Scale          $0.004569    -15.21%  mcap $45.69M
#10  HAEDAL  Haedal Protocol            $0.02258    -14.19%  mcap $12.61M

=== Trend Candidates (>+5% 24h) ===
MOW +219998.18%, AKE +92.05%, BARD +66.21%, MAGMA +18.83%, OSMO +12.93%, DODO +15.74%, ARIA +11.14%, DNA +13.64%, HUMA +12.72%, XPR +11.74%
```

## Related tools

- [Spot & Perp Quotes](https://www.f1ow.com/docs/tools/market_quotes) — Spot and perp mark side by side, with funding, open interest, long/short ratio and the day's liquidations. Five providers merged into one snapshot, cached for thirty seconds.
- [Candles](https://www.f1ow.com/docs/tools/market_candles) — Spot or perpetual OHLCV candles with venue routing and fallback, for the timeframes your analysis needs. For months of paged candles or derivatives series, use Bulk History.
- [Bulk History](https://www.f1ow.com/docs/tools/market_history) — Paged spot/perp candles, aggregate open interest, funding or long/short liquidations. Up to 1,000 rows per call with a backward-page cursor, explicit time bounds and a forming-row flag — for historical research and backtests.
- [Market Overview](https://www.f1ow.com/docs/tools/market_overview) — The global frame in one read: total market cap, BTC and ETH dominance, Fear & Greed, Altcoin Season.