> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# News Feed API

> Retrieve aggregated crypto, macro, and geopolitics news articles with filtering by category, coin, and date.

The News Feed endpoint aggregates articles from dozens of RSS sources across crypto, traditional finance, macro economics, geopolitics, research, and AI. Articles are scored by source tier (1-3) and enriched with coin tags for filtering.

***

## Get news articles

`GET /v1/news/feed`

Returns a paginated, story-deduplicated list of news articles ordered by publish date descending. Supports full-corpus title search plus filtering by category, coin tag, and date range.

Each article gives the headline, source, publish time and a `link` to the original story. `summary` is always `null`: Sharpe does not store or serve publishers' summaries, so open `link` to read the article. The field stays so existing clients keep working.

`coin_tags` holds canonical asset ids (`bitcoin`); `coin_symbols` gives each one's ticker in the same order (`BTC`), `null` where no ticker is on record.

### Query parameters

**limit** `integer`

Number of articles to return. Between `1` and `500`. Defaults to `200`.

**offset** `integer`

Number of articles to skip for pagination. Minimum `0`. Defaults to `0`.

**category** `string`

Filter the aggregated feed by category. One of `all`, `crypto`, `tradfi`, `macro`, `geopolitics`, `research`, `ai`. Defaults to returning all categories.

**coin** `string`

Filter articles mentioning a specific coin. Accepts a ticker (`BTC`, `ETH`, `SOL`) or a canonical asset id (`bitcoin`, `ethereum`, `solana`) and resolves it against the canonical `coin_tags` ids stored with each article.

**since** `string`

ISO 8601 date string. Only return articles published on or after this timestamp.

**q** `string`

Search article titles across the stored corpus. Between `1` and `200` characters.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/news/feed \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d limit=10 \
  -d category=crypto
```

```ts TypeScript theme={null}
const params = new URLSearchParams({
  limit: '10',
  category: 'crypto',
})
const res = await fetch(
  `https://www.sharpe.ai/api/v1/news/feed?${params}`,
  {
    headers: { Authorization: 'Bearer sk_live_your_key_here' },
  },
)
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/news/feed",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
    params={"limit": 10, "category": "crypto"},
)
data = resp.json()["data"]
```

```json Response theme={null}
{
  "data": {
    "articles": [
      {
        "id": 48201,
        "title": "Bitcoin Surges Past $95K as ETF Inflows Hit Record",
        "summary": null,
        "author": "CoinDesk Staff",
        "tags": ["bitcoin", "etf", "institutional"],
        "link": "https://coindesk.com/...",
        "source": "CoinDesk",
        "source_tier": 1,
        "published": "2026-03-28T10:30:00Z",
        "fetched_at": "2026-03-28T10:35:00Z",
        "coin_tags": ["bitcoin"],
        "coin_symbols": ["BTC"],
        "category": "crypto"
      },
      {
        "id": 48200,
        "title": "Federal Reserve issues FOMC statement",
        "summary": null,
        "author": null,
        "tags": ["fed", "rates", "macro"],
        "link": "https://www.federalreserve.gov/newsevents/pressreleases/...",
        "source": "Federal Reserve",
        "source_tier": 1,
        "published": "2026-03-28T09:15:00Z",
        "fetched_at": "2026-03-28T09:20:00Z",
        "coin_tags": [],
        "coin_symbols": [],
        "category": "macro"
      }
    ],
    "total": 11,
    "next_offset": 10,
    "truncated": false
  },
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-03-28T10:36:00Z",
    "elapsed_ms": 12
  }
}
```

***

## Pagination

Use `offset` and `limit` for pagination. Deduplication happens before the offset is applied, so adjacent pages do not overlap when the same story appears from multiple publishers. Use the returned `next_offset`; a `null` value means the scan is complete.

Some publishers (Reuters, AP News, Messari, The Information and a few others) are read through Google News. Their `title` is the publisher's headline, but their `link` is a `news.google.com` redirect to the article rather than the publisher's own URL.

`total` is exact when the bounded corpus scan reaches the end and otherwise is a lower-bound estimate. `truncated: true` means the safety cap was reached before the complete filtered corpus could be scanned.

`GET /v1/news/feed?offset=200&limit=200`

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/news/feed \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d limit=200 \
  -d offset=200
```

```ts TypeScript theme={null}
const res = await fetch(
  'https://www.sharpe.ai/api/v1/news/feed?offset=200&limit=200',
  {
    headers: { Authorization: 'Bearer sk_live_your_key_here' },
  },
)
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/news/feed",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
    params={"limit": 200, "offset": 200},
)
data = resp.json()["data"]
```

[Read the error reference](https://docs.sharpe.ai/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.