// developer api · v1

Traders News API

REST endpoints for the real-time squawk feed, top movers, and quotes. Built for trading bots, dashboards, and Discord/Slack relays.

Pro subscribers only600 req / min / keyJSON · HTTPS

Authentication

Generate a key from /api-keys (signed-in Pro account required). Send it as a bearer token on every request.

Authorization: Bearer tn_live_XXXXXXXXXXXXXXXXXXXXXXXX

Base URL

https://tradersnews.net/api/public/v1

Endpoints

GET/squawks

Recent headlines from all ingested wires, central banks, FX desks, and social sources.

Query params

limit — 1–200, default 50
category — WIRES | MACRO | EQUITIES | FX | SOCIAL | CENTRAL_BANKS
ticker — Symbol filter, e.g. AAPL
since — ISO timestamp, e.g. 2026-06-26T12:00:00Z

Example

curl -H "Authorization: Bearer $TN_KEY" \
  "https://tradersnews.net/api/public/v1/squawks?limit=20&category=EQUITIES&ticker=AAPL"

GET/movers

Real-time top gainers / losers from the US stock market (Polygon-backed).

Query params

direction — gainers | losers (default gainers)
limit — 1–50, default 20

Example

curl -H "Authorization: Bearer $TN_KEY" \
  "https://tradersnews.net/api/public/v1/movers?direction=losers&limit=10"

GET/quote

Real-time snapshot for a single symbol: last, bid/ask, OHLC, volume, daily change.

Query params

symbol — Required, e.g. TSLA

Example

curl -H "Authorization: Bearer $TN_KEY" "https://tradersnews.net/api/public/v1/quote?symbol=TSLA"

Rate limits

600 requests / minute / key, sliding window. Responses include X-RateLimit-Limit, X-RateLimit-Remaining. On 429, honor Retry-After (seconds).

Status codes

200 — Success
400 — Bad request / missing param
401 — Missing or invalid API key
402 — Subscription required
429 — Rate limited
5xx — Server / upstream error

Streaming & webhooks

WebSocket streaming (wss://tradersnews.net/v1/stream) and push webhooks are on the roadmap. Email api@tradersnews.net if you need early access.

// node example

const res = await fetch("https://tradersnews.net/api/public/v1/squawks?limit=5", {
  headers: { Authorization: "Bearer " + process.env.TN_KEY }
});
const { items } = await res.json();
console.log(items);