# Trading Signals Toolkit

> Trading data API for AI agents and traders: futures event-risk gates and session briefs from US government macro data, AI-written trade briefs, macro event studies, SEC Form 4 insider buys and cluster buys, SEC 13F fund holdings, Base and Solana token safety verdicts, OFAC sanctions screening for crypto addresses and names, wallet pay-readiness checks, a one-call token pre-trade pack, and quant calculators. Use the free tier (100 calls/month, API key) or pay per call over x402 in USDC on Base (eip155:8453) or Solana. Informational only, not investment advice.

## Access

- Free tier: POST https://signals.incomefather.com/billing/free with JSON {"email": "you@example.com"} returns a tsk_ API key once. Send it as the x-api-key header (or Authorization: Bearer). 100 calls per 30 days; /ai/trade-brief uses 20.
- Pay per call (x402 v2, exact scheme): an unpaid request returns HTTP 402 with a PAYMENT-REQUIRED header listing price, network and payTo. Sign and retry with PAYMENT-SIGNATURE. No account or key needed. Failed calls (4xx/5xx) are never settled.
- Plans: Starter $29/month (10k calls), Pro $99/month (100k calls). https://signals.incomefather.com/pricing

## Routes

- GET https://signals.incomefather.com/ai/trade-brief ($0.08): AI Trade Brief: a short structured pre-trade brief for ES/NQ/CL/GC/ZN (bias, confidence, key levels, risks, catalysts, trade-plan notes) written by an LLM strictly from the toolkit's own data: event-risk gate, session brief (calendar, yields, CFTC positioning), SEC insider clusters and the macro event study for the next high-impact release
- GET https://signals.incomefather.com/bundle/pre-trade-check ($0.10): Pre-Trade Check: one GO / CAUTION / NO_GO answer with plain reasons for ES/NQ/CL/GC/ZN, combining the event-risk gate, the symbol session brief (calendar, yields, CFTC positioning), SEC Form 4 insider activity (your ticker, or top market-wide clusters) and an optional Base token verdict
- GET https://signals.incomefather.com/bundle/token-pre-trade ($0.025): Token Pre-Trade Pack: one GO / CAUTION / STOP answer for a Solana or Base token, combining the token safety verdict, an OFAC screen of the token's mint/freeze authority or owner and an optional counterparty wallet, and that wallet's pay-readiness for a USDC amount
- GET https://signals.incomefather.com/futures/event-study ($0.02): Macro Event Study (what happened last time): ES/NQ/RTY/ZN proxy moves at +5/+15/+30/+60 min after each of the last N CPI, NFP, FOMC, PPI, retail sales, GDP or PCE releases (% and approx
- GET https://signals.incomefather.com/futures/session-brief ($0.03): Futures Session Brief for ES/NQ/CL/GC/ZN: next US high-impact releases (BLS, FOMC, Treasury auctions, jobless claims) with ET times & minutes-to, latest/prior BLS values, Treasury 2s/10s/2s10s + daily change, CFTC COT net positioning with 3y percentile, holiday/early-close flags, and a safeToTrade verdict
- GET https://signals.incomefather.com/futures/cot-screener ($0.02): CFTC COT Screener: weekly large-speculator (non-commercial) positioning across 45 futures markets (equity indexes, VIX, Treasuries, SOFR, energy, metals, grains, livestock, softs, FX, BTC/ETH): net, % of open interest, weekly change, 3-year percentile, crowded_long / crowded_short flags, biggest shifts and net flips
- GET https://signals.incomefather.com/rates/treasury-desk ($0.01): Treasury Auction and Yields Desk: today's Treasury par curve (1m-30y) with 2s10s, 3m10y, 5s30s and 1-day/1-week/1-month changes in bp; upcoming coupon auctions with ET close time and minutes-to (reopenings labeled); recent results with high yield, bid-to-cover, indirect/direct/dealer shares vs the prior 6 same-security auctions and a demand label
- GET https://signals.incomefather.com/futures/event-gate ($0.01): Event-Risk Gate: one-call safeToTrade verdict + next high-impact US release (BLS CPI/NFP/PPI, FOMC, Treasury auctions) within a minutes window
- GET https://signals.incomefather.com/base/token-verdict ($0.02): Base token verdict A-F: ERC-20 metadata & supply, owner/renounced, EIP-1967 proxy/upgradeable check, Uniswap v2/v3 + Aerodrome liquidity vs WETH/USDC, buy→sell honeypot simulation with taxes (eth_call), known-holder concentration
- GET https://signals.incomefather.com/solana/token-verdict ($0.02): Solana token verdict (safe / caution / avoid + A-F grade) for an SPL or Token-2022 mint: mint and freeze authority (renounced or not), supply, Token-2022 risk extensions (transfer fee, transfer hook, permanent delegate, non-transferable, default-frozen, pausable), DEX liquidity, first-pool age, holder concentration and a live ~$1k sell-route test to USDC with price impact, with plain reasons, timestamp and sources
- GET https://signals.incomefather.com/compliance/sanctions-screen ($0.01): OFAC sanctions screen: check a crypto address on any chain (EVM/Base, Bitcoin, Tron, Solana and more) and/or a name (fuzzy, scored 0-100) against the official US Treasury OFAC SDN and Consolidated lists, refreshed twice a day
- GET https://signals.incomefather.com/wallet/pay-readiness ($0.01): Wallet pay-readiness for Base or Solana: ETH/SOL and USDC balances, whether the wallet can pay a USDC amount over x402 or by direct transfer, shortfalls, USDC blacklist / frozen-account flags, wallet type (EOA, contract, EIP-7702) and open token approvals to known spenders, with an ok / review / cannot_pay status
- GET https://signals.incomefather.com/sec/insider-buys ($0.01): SEC Form 4 open-market insider purchases (code P) for one ticker: insider, role, shares, price, value, dates, per-insider totals, cluster flag
- GET https://signals.incomefather.com/sec/insider-clusters ($0.02): Market-wide insider cluster buys: listed tickers with >=3 distinct insiders making open-market purchases (Form 4 code P) in the last N days, with buyers, roles, totals and VWAP
- GET https://signals.incomefather.com/sec/13f-holdings ($0.02): SEC Form 13F holdings for one fund manager (CIK or name): latest 13F-HR top positions with ticker, CUSIP, shares, value and % of portfolio, totals, and quarter-over-quarter changes (new, added, trimmed, exited) vs the prior 13F, with filing date, period and EDGAR links
- GET https://signals.incomefather.com/sec/13f-holders ($0.02): Which notable fund managers hold a stock, from their latest SEC 13F-HR filings: Berkshire Hathaway, Pershing Square, Bridgewater, Baupost, Duquesne, Appaloosa, Soros, Tiger Global, Coatue, ARK and ~17 more
- POST https://signals.incomefather.com/quant/vwap-bands ($0.005): VWAP + standard-deviation bands from your OHLCV bars (session-anchored or full), z-score and band position
- POST https://signals.incomefather.com/quant/orb ($0.005): Opening range (first N minutes) high/low/size for the latest session in your bars, breakout state, first breakout, 1x/2x extension targets
- POST https://signals.incomefather.com/quant/atr-stop ($0.005): Wilder ATR, ATR-multiple stop and position size from account risk %
- POST https://signals.incomefather.com/quant/backtest-orb ($0.02): Opening-range-breakout backtest on your intraday bars: trades, win rate, avg R, total R, profit factor, max drawdown, exits, long/short split, recent trades

## Machine-readable

- OpenAPI: https://signals.incomefather.com/openapi.json
- x402 discovery: https://signals.incomefather.com/.well-known/x402
- Remote MCP server (Streamable HTTP, no install): https://signals.incomefather.com/mcp — add it as a custom connector in Claude, ChatGPT, Cursor, Perplexity or any MCP client. 20 read-only tools. No key: small anonymous daily allowance (AI trade brief 1/day). Send a free or paid key as "Authorization: Bearer tsk_..." (or x-api-key, or ?key=tsk_... on the URL for clients that cannot set headers) for the plan quota.
- Local MCP server that pays per call over x402 from your own wallet: npx -y x402-trading-signals-mcp (https://github.com/gdietsch/trading-signals-mcp)
- Logo: https://signals.incomefather.com/logo.png (512x512), https://signals.incomefather.com/logo-400.png (400x400)

## Legal

- Privacy policy: https://signals.incomefather.com/privacy
- Terms of service: https://signals.incomefather.com/terms
- Support: https://signals.incomefather.com/support
- Contact: gdietsch-j16thn@mail.grokbot.com

## Examples

- Copy-paste code (curl, JavaScript @x402/fetch, Python x402, Claude Desktop/Cursor/Cline MCP, LangChain, OpenAI Agents SDK): https://github.com/gdietsch/trading-signals-examples
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/futures/event-gate?window=30"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/sec/insider-clusters?days=7&minBuyers=3"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/ai/trade-brief?symbol=ES&window=30"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/solana/token-verdict?mint=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/compliance/sanctions-screen?address=0xdcbEfFBECcE100cCE9E4b153C4e15cB885643193"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/wallet/pay-readiness?address=0x6d7be981c103eD360874a7703ad3CD6a98929aFB&amount=0.01"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/sec/13f-holdings?cik=1067983&top=10"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/sec/13f-holders?ticker=AAPL"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/futures/cot-screener?extreme=1"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/rates/treasury-desk?days=14"
- curl -H "x-api-key: $KEY" "https://signals.incomefather.com/bundle/token-pre-trade?token=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263&wallet=0x6d7be981c103eD360874a7703ad3CD6a98929aFB&amount=0.01"

## Guides

- [ES futures session brief API](https://signals.incomefather.com/guides/es-futures-session-brief-api): One JSON call for E-mini S&P 500 (ES), NQ, CL, GC and ZN: next CPI/NFP/PPI/FOMC release in ET, latest values, Treasury 2y/10y, CFTC positioning and a safe-to-trade verdict.
- [SEC insider buying API](https://signals.incomefather.com/guides/sec-insider-buying-api): JSON API for SEC Form 4 open-market insider purchases by ticker, and cluster buys where 3+ insiders bought the same stock. Parsed from EDGAR, from $0.01 per call or free tier.
- [AI trade brief API for agents](https://signals.incomefather.com/guides/ai-trade-brief-api): 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.
- [Solana token safety check API](https://signals.incomefather.com/guides/solana-token-safety-check-api): One call returns safe, caution or avoid for any Solana token mint, with reasons: mint and freeze authority, Token-2022 transfer fees, hooks and permanent delegates, liquidity, pool age, holder concentration and a live sell-route test.
- [OFAC sanctions screening API for crypto addresses and names](https://signals.incomefather.com/guides/ofac-sanctions-screening-api): One call screens a crypto address on any chain, and/or a person or company name, against the official US Treasury OFAC SDN and Consolidated lists. Returns clear, match or possible_match with the matched entries and the list date.
- [Wallet pay-readiness API for Base and Solana](https://signals.incomefather.com/guides/wallet-pay-readiness-api): One call tells an agent whether a Base or Solana wallet can pay a USDC amount: balances, shortfalls, USDC blacklist or frozen flags, wallet type and open token approvals. Returns ok, review or cannot_pay for $0.01.
- [SEC 13F holdings API for fund portfolios and notable holders](https://signals.incomefather.com/guides/sec-13f-holdings-api): Get a fund manager's latest 13F holdings by CIK or name, with value, % of portfolio and quarter-over-quarter changes (new, added, trimmed, exited). Or ask which notable funds hold a stock. From SEC EDGAR, as filed.
- [Token pre-trade check API for Solana and Base](https://signals.incomefather.com/guides/token-pre-trade-check-api): One call before an agent buys a token or pays a counterparty: token safety verdict, OFAC screen of the wallet and the token's authorities, and the wallet's pay-readiness, combined into GO, CAUTION or STOP with plain reasons.
- [CFTC COT positioning screener API](https://signals.incomefather.com/guides/cftc-cot-positioning-screener-api): One call for weekly Commitments of Traders positioning across 45 futures markets: large-speculator net, % of open interest, weekly change, 3-year percentile and crowded long or short flags.
- [Treasury auction and yields API](https://signals.incomefather.com/guides/treasury-auction-yields-api): One call for a US rates snapshot: Treasury par curve with 2s10s, 3m10y and 5s30s and their changes, upcoming Treasury auctions with ET close times, and recent results with bid-to-cover and dealer share versus prior auctions.
- [x402 pay-per-call market data](https://signals.incomefather.com/guides/x402-pay-per-call-market-data): How to buy market data per request with x402 (HTTP 402 + USDC on Base or Solana): no account or API key. Copy-paste examples in curl, JavaScript, Python and MCP.