TradeMCP News Docs

Live stream

Every enriched article as it happens, over a WebSocket.

wss://news.trademcp.dev/v1/stream?api_key=…&symbols=BTC,ETH&min_impact=0.3 (scope stream:read)

You get one JSON message per enriched article, in the same shape as a webhook's article. Both filters are optional.

websocat "wss://news.trademcp.dev/v1/stream?api_key=$NEWS_KEY&symbols=XAUUSD,USD&min_impact=0.3"
{"title": "Gold extends record run as dollar slips", "symbols": ["XAUUSD", "USD"], "impact": 0.47, "…": "…"}

The stream is live only: nothing is replayed. When you reconnect, fill the gap with /v1/news/search and since=<last published_at you saw>.

A connection with a missing or invalid key is closed with code 4401, and one whose key lacks stream:read with 4403.