REST API — ELITE PLAN

TradeAI News REST API

Integrate catalyst-driven signals, TMS scores, and options flow data directly into your trading system. Available on the ELITE plan.

Get ELITE Access →

BASE URL

https://api.tradeainews.com

AUTHENTICATION

Authenticate every request with your API key using the X-API-Key header. Generate keys in your dashboard.

BASH

curl https://api.tradeainews.com/v1/signals/recent \
  -H "X-API-Key: tai_your_key_here"

Rate limit: 60 requests/minute per key. Exceeding this returns HTTP 429.

SIGNAL OBJECT FIELDS

signal_idUUIDUnique signal identifier

tickerstringEquity ticker (e.g. AAPL)

event_dateISO8601When the catalyst was detected

catalyst_typestringEvent category (e.g. FDA_APPROVAL, EARNINGS)

headlinestringSource headline text

top_mover_scorefloatTradeAI TMS score 0–100 (≥82 SEND_NOW, ≥68 PREMIUM)

tierstringSEND_NOW | SEND_PREMIUM | WATCH

subsystem_scoresobjectss1–ss6 component scores (0–100 each)

expected_move_pctfloatModel-predicted price move percentage

ret_1h / ret_4h / ret_1dfloatRealized return at 1h, 4h, 1d (if filled)

sectorstringGICS sector

Endpoints

Python Quickstart

PYTHON

import requests

API_KEY  = "tai_your_key_here"
BASE_URL = "https://api.tradeainews.com"
HEADERS  = {"X-API-Key": API_KEY}

# Get top movers from the last 24h with TMS >= 75
resp = requests.get(
    f"{BASE_URL}/v1/signals/top-movers",
    headers=HEADERS,
    params={"min_score": 75, "hours": 24, "limit": 10},
)
resp.raise_for_status()

for signal in resp.json():
    print(
        f"{signal['ticker']:6s}  "
        f"TMS={signal['top_mover_score']:5.1f}  "
        f"tier={signal['tier']:12s}  "
        f"{signal['headline'][:70]}"
    )

Ready to build?

API access is included with the ELITE plan.

Get ELITE Access →