News feed

All endpoints on this page are Platform API endpoints.

GET /v1/news/feed

Return the filterable activity feed used by the floating market feed.

• Auth: x-api-key
• Scope: assets:read

Modes

• Global mode: omit token params. The response can include global CoinGecko news, recent @tokens posts, or both depending on source.
• Token mode: pass coin_id and/or matching terms. The response can include token-specific CoinGecko news, matching @tokens posts, or both depending on source.

Query params

• limit (optional): integer 1–50, default 10
• source (optional): all, news, or tweets, default all
• tweet_reserve (optional): integer 0–limit, default 3. Reserves visible slots for matching @tokens posts when source=all.
• coin_id (optional): CoinGecko coin id, such as bitcoin or solana
• symbol (optional): token symbol used to match related @tokens posts, such as BTC
• name (optional): token/display name used to match related @tokens posts, such as Bitcoin
• asset_id (optional): canonical asset id used as an additional matching term
• terms (optional): comma-separated related terms
• term (optional): repeatable related term param

Response

interface NewsFeedResponse {
    items: Array<{
        title: string;
        url: string;
        image: string;
        author: string;
        posted_at: string;
        type: 'news';
        source_name: string;
        related_coin_ids: string[];
        feed_source: 'coingecko' | 'x';
    }>;
    meta: {
        mode: 'global' | 'token';
        source: 'all' | 'news' | 'tweets';
        coin_id: string | null;
        terms: string[];
        limit: number;
        tweet_reserve: number;
        counts: {
            items: number;
            coingecko_candidates: number;
            x_candidates: number;
        };
    };
}

Examples

Global feed:

curl -sS "$API_BASE_URL/v1/news/feed?source=all&limit=25&tweet_reserve=3" \
  -H "x-api-key: $API_KEY"

Bitcoin-specific feed:

curl -sS "$API_BASE_URL/v1/news/feed?coin_id=bitcoin&symbol=BTC&name=Bitcoin&source=news&limit=50" \
  -H "x-api-key: $API_KEY"

Tweet-only token feed:

curl -sS "$API_BASE_URL/v1/news/feed?terms=solana,SOL&source=tweets&limit=50" \
  -H "x-api-key: $API_KEY"

Notes

• feed_source="coingecko" items come from CoinGecko news.
• feed_source="x" items come from @tokens on X.
• In token mode, @tokens posts are included only when their text/source metadata matches the supplied token terms.
• limit supports up to 50; larger values are clamped to 50.
• tweet_reserve is ignored for single-source feeds (source=news or source=tweets).
• Upstream provider failures are best-effort: the endpoint can return a partial feed when either CoinGecko or X is unavailable.