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

# Introduction

> Real-time trading news API for quant developers

# Welcome to TradingNews

TradingNews is a unified trading news API that aggregates breaking financial news from multiple sources into a single, structured stream. Built for individual quant traders and algo developers.

## What you get

<CardGroup cols={2}>
  <Card title="REST API" icon="code">
    Query news by urgency or time range. Simple GET requests with JSON responses.
  </Card>

  <Card title="WebSocket Stream" icon="bolt">
    Real-time firehose delivery. Connect and receive all articles as they arrive (Pro and Max plans).
  </Card>

  <Card title="Priority Scoring" icon="arrow-up-right-dots">
    Every article tagged with urgency level — breaking, flash, or regular. Filter for what matters.
  </Card>

  <Card title="Semantic Search & Per-Ticker Sentiment" icon="magnifying-glass">
    Max plan adds natural-language search over the article archive (`/v1/news/search`) and per-ticker sentiment on every response.
  </Card>

  <Card title="Simple Pricing" icon="gauge-high">
    Rate-limit-based plans: Starter $20/mo, Pro $50/mo, Max \$100/mo. Save 30% with annual billing.
  </Card>
</CardGroup>

## Data Sources

TradingNews aggregates from multiple curated financial news sources covering US equities, macro events, and global markets. All data is normalized into a consistent format. New sources are added regularly.

## Quick Example

```bash theme={null}
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.tradingnews.press/v1/news?limit=5"
```

```json theme={null}
{
  "count": 5,
  "articles": [
    {
      "id": "01KNKV33C9DDADR1HRRWGCSA8V",
      "content": "Apple announces record Q2 earnings, beats estimates by 12%",
      "urgency": "breaking",
      "sentiment": null,
      "published_at": "2026-04-07T14:30:00Z",
      "received_at": "2026-04-07T14:30:02Z"
    }
  ]
}
```