Skip to main content
GET
/
v1
/
news
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.tradingnews.press/v1/news?limit=5&urgency=breaking"
{
  "count": 1,
  "articles": [
    {
      "id": "01KNKV33C9DDADR1HRRWGCSA8V",
      "content": "Apple announces record Q2 earnings, beats estimates by 12%",
      "urgency": "breaking",
      "sentiment": null,
      "published_at": "2026-04-07T14:30:00+00:00",
      "received_at": "2026-04-07T14:30:02.123456+00:00"
    }
  ]
}

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.

Query Parameters

limit
integer
default:"50"
Number of articles to return. Min: 1, Max: 100.
since
string
Only return articles received after this ISO 8601 datetime. Example: 2026-04-07T00:00:00Z
urgency
string
Filter by urgency level: breaking, flash, or regular.

Response

count
integer
Number of articles returned.
articles
Article[]
Array of article objects. Max-plan responses additionally include a tickers array on each article (per-ticker sentiment, e.g. [{"ticker": "AAPL", "sentiment": "positive"}]). Starter and Pro responses omit the field.
Starter keys can query articles received in the last 24 hours; Pro and Max keys can query the last 7 days. Older since values are silently clamped to the allowed window.
curl -H "X-API-Key: YOUR_KEY" \
  "https://api.tradingnews.press/v1/news?limit=5&urgency=breaking"
{
  "count": 1,
  "articles": [
    {
      "id": "01KNKV33C9DDADR1HRRWGCSA8V",
      "content": "Apple announces record Q2 earnings, beats estimates by 12%",
      "urgency": "breaking",
      "sentiment": null,
      "published_at": "2026-04-07T14:30:00+00:00",
      "received_at": "2026-04-07T14:30:02.123456+00:00"
    }
  ]
}