curl -s -H "X-API-Key: <YOUR_KEY>" \
"https://<api.united-river.com>/api/v1/briefs/us?format=json"
GET /api/v1/briefs/us?format=json HTTP/1.1
Host: <api.united-river.com>
X-API-Key: <YOUR_KEY>
Accept: application/json
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/briefs/{market}?format=json|html |
Market brief feed (US / europe / asia / world / crypto / etf / fx). |
| GET | /api/v1/movers/{market}?session=premarket|regular |
Top movers & leaders/laggards (for “Top Movers” tab/cards). |
| GET | /api/v1/categories |
Available categories (title, description, key) for navigation. |
| GET | /api/v1/articles?cat=technology&limit=50 |
Published articles list (for “News” pages, RSS generation, or bots). |
| GET | /api/v1/articles/{id} |
Single article (content + metadata + source URL). |
| GET | /api/v1/symbols/search?q=AAPL |
Search symbols (canonical ticker, name, exchange, aliases). |
| POST | /api/v1/watchlist/brief |
Batch brief for a list of symbols (JSON body) for newsletters/portals. |
{
"market": "us",
"asOf": "2026-01-07T01:15:00Z",
"timezoneLabel": "New York (ET)",
"items": [
{
"type": "top_news",
"title": "AAPL (Apple Inc.)",
"summary": "Reported growth in sales; positive momentum despite tariff concerns.",
"tags": ["technology"],
"sourceUrl": "https://example.com/source",
"symbols": ["AAPL"]
}
]
}