Skip to main content

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.

​
1. Get your API key

Sign up at tradingnews.press and create an API key from your dashboard. Your key looks like: tn_live_a8f3k2m1n...
First-time subscribers can start with a 3-day free trial on Starter or Pro (card required, cancel anytime before the trial ends to avoid being charged). Max does not offer a trial.

​
2. Make your first request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.tradingnews.press/v1/news?limit=5"

​
3. Stream real-time news

Connect via WebSocket for live updates (Pro and Max plans): 
import asyncio
import json
import websockets

async def stream():
    uri = "wss://api.tradingnews.press/v1/stream?api_key=YOUR_KEY"
    async with websockets.connect(uri) as ws:
        # Firehose — all articles are pushed automatically
        async for message in ws:
            article = json.loads(message)
            print(f"[{article['urgency']}] {article['content']}")

asyncio.run(stream())

​
4. Check your usage

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.tradingnews.press/v1/account/usage"

{
  "tier": "starter",
  "rate_limit": 1,
  "period_end": "2026-05-07T00:00:00Z"
}

​
Next steps