AI trade brief API for agents

GET /ai/trade-brief returns a short structured futures brief (bias, key levels, risks, catalysts, trade plan) written by an LLM only from live event-risk, macro and insider data. $0.08 per call.

Asking a general-purpose model "should I trade ES right now?" gets you confident text with no idea of the economic calendar, today's yields or the daily halt. GET /ai/trade-brief flips that around: it gathers facts from this toolkit's own data first (pre-trade check, session brief, SEC insider clusters, and a macro event study for the next high-impact release), then has a model phrase a short JSON brief from those facts only.

Response shape

{
  "symbol": "ES",
  "tradeability": "GO | CAUTION | NO_GO",
  "brief": {
    "headline": "...",
    "bias": "bullish | bearish | neutral | stand_aside",
    "confidence": "low | medium | high",
    "summary": "...",
    "keyLevels": [{ "label": "...", "value": "...", "basis": "..." }],
    "risks": ["..."],
    "catalysts": [{ "event": "...", "whenEt": "...", "impact": "..." }],
    "tradePlan": { "entryIdea": "...", "stopIdea": "...", "invalidation": "..." }
  },
  "inputs": { "...": "the facts the brief was written from" },
  "disclaimer": "Not investment advice."
}

Real excerpt (ES, Nov 10, 2026, 5:52 PM ET)

"headline": "ES: stand aside—Globex is in the daily halt",
"bias": "stand_aside",
"keyLevels": [
  { "label": "PPI typical 15-minute move",
    "value": "9.09 points median; 15.89 points at the 80th percentile" },
  { "label": "Suggested stop width",
    "value": "15.86 points; conservative width 21.64 points" }
],
"catalysts": [
  { "event": "Unemployment Insurance Weekly Claims", "whenEt": "Thu Nov 12 08:30 ET", "impact": "medium" },
  { "event": "Producer Price Index", "whenEt": "Fri Nov 13 08:30 ET", "impact": "high" }
]

Guardrails

Catalyst names and times are filled in from the calendar, not by the model.
A NO_GO pre-trade check always forces bias: "stand_aside".
If the AI upstream is unavailable the route returns 503 before payment settles, so you are never charged for a missing brief.
Briefs are cached 60 seconds per symbol and window.

Parameters and price

symbol: ES, NQ, CL, GC or ZN. window: minutes ahead (default 30). Optional price lets the brief convert typical moves into levels. $0.08 per call over x402 (USDC on Base or Solana), or 20 units on API-key plans.

Try it free

Get a free API key (100 calls a month, no card), then pass it in the x-api-key header. This route uses 20 units (so up to 5 briefs on the free tier) of the monthly quota.

curl -X POST https://signals.incomefather.com/billing/free \
  -H 'content-type: application/json' -d '{"email":"you@example.com"}'

curl -H "x-api-key: $TRADING_SIGNALS_API_KEY" \
  "https://signals.incomefather.com/ai/trade-brief?symbol=ES&window=30"

Agents that hold a wallet can skip the key entirely and pay per call over x402 (see x402 pay-per-call market data). Copy-paste code for curl, JavaScript, Python, MCP (Claude Desktop, Cursor, Cline), LangChain and the OpenAI Agents SDK is in gdietsch/trading-signals-examples.