---
title: "Feed Trending"
method: GET
path: "/v1/feed/trending"
tags: ["feed"]
---

# Feed Trending

`GET /v1/feed/trending`

## Request

- Base URL: `https://api.bitpoort.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bitpoort.com/v1/feed/trending`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Get trending tokens by swap volume with trend indicators.

Compares recent swap volume against the preceding period of the same
length to compute change percentage and trend direction.  Enriched with
price estimates and 24h volume sparklines for charting.

## Query parameters

- `chain` string: Chain to get trending tokens for
- `hours` integer: Lookback period in hours
- `limit` integer: Number of tokens to return

## Response `200`

Successful Response

- TrendingResponse
  - `tokens` TrendingToken[], required
    - `symbol` string, required
    - `token_address` string, required
    - `swap_count` integer, required
    - `volume_usd` number, required
    - `buy_volume_usd` number, required
    - `sell_volume_usd` number, required
    - `unique_wallets` integer, required
    - `change_pct` number, required
    - `trend` string, required: up, down, or flat
    - `buy_sell_ratio` number, required
    - `price_usd` number, nullable: Current price estimate (from known tokens)
    - `volume_24h_sparkline` number[]: 24 hourly volume buckets (oldest→newest) for sparkline chart
  - `chain` string, required
  - `period_hours` integer, required

## Other responses

- `422`: Validation Error

---

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