# Trending (`market_trending`)

> What the market is looking up right now, ranked.

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

## What it does

Lists the currently trending cryptocurrencies

## Parameters

None.

## Call it

### cURL

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

### MCP

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

### TypeScript

```ts
const res = await fetch("https://mcp.f1ow.com/v1/market/trending", {
  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/trending",
    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_trending",
    "arguments": {}
  }
}

// Or push a fresh result whenever it changes (minimum interval 15 s)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "subscriptions/subscribe",
  "params": {
    "name": "market_trending",
    "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/trending"
```

## Sample response

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

```json
{
  "coins": [
    {
      "marketCapRank": 967,
      "name": "ni hao cat",
      "symbol": "MIHAO"
    },
    {
      "marketCapRank": 984,
      "name": "AudaCity",
      "symbol": "DACITYCOIN"
    },
    {
      "marketCapRank": 1,
      "name": "Bitcoin",
      "symbol": "BTC"
    },
    {
      "marketCapRank": 2,
      "name": "Ethereum",
      "symbol": "ETH"
    },
    {
      "marketCapRank": 11,
      "name": "Zcash",
      "symbol": "ZEC"
    },
    {
      "marketCapRank": 10,
      "name": "Hyperliquid",
      "symbol": "HYPE"
    },
    "… 9 more"
  ],
  "generatedAt": "2026-11-13T08:05:39.0819607+00:00"
}
```

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

```text
MIHAO - ni hao cat (rank #967)
DACITYCOIN - AudaCity (rank #984)
BTC - Bitcoin (rank #1)
ETH - Ethereum (rank #2)
ZEC - Zcash (rank #11)
HYPE - Hyperliquid (rank #10)
SOL - Solana (rank #7)
SUI - Sui (rank #28)
LIT - Lighter (rank #79)
TAO - Bittensor (rank #38)
AKE - Akedo (rank #251)
AERO - Aero (rank #118)
MON - Monad (rank #162)
SANC - Sanctum (rank #442)
PENGU - Pudgy Penguins (rank #116)
```

## 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.