Base URL
Authentication
All endpoints require an API key via theX-API-Key header:
Response Format
All responses are JSON. Successful responses return200. Error responses include a detail field:
Article Schema
Every article returned by the API follows this structure:| Field | Type | Description |
|---|---|---|
id | string | Unique ULID, sortable by time |
content | string | Article text (headline or full content) |
urgency | string | breaking, flash, or regular |
sentiment | string? | Sentiment label (when available) |
published_at | string? | ISO 8601 publication time |
received_at | string | ISO 8601 time TradingNews received the article |
Endpoints
| Method | Path | Description | Access |
|---|---|---|---|
| GET | /v1/news | List recent articles | Starter + Pro |
| GET | /v1/news/{id} | Get single article | Starter + Pro |
| WS | /v1/stream | Real-time firehose stream | Pro only |
| GET | /v1/account/usage | Check plan and rate limit | Starter + Pro |