API Guide — Connect Your Data Stack

TradeMe is powered by your API keys. You choose which data sources to connect based on your needs and budget. The app works with zero paid APIs out of the box, but scales dramatically as you add more. Below is every API the system supports — what it does, what it costs, and where to get a key.

Essential & Strongly Recommended

These two paid APIs unlock the full power of TradeMe. Everything else is free or built in.

🧠 Anthropic Claude

Essential — Powers All AI Features

Claude Sonnet by Anthropic is the AI engine behind every intelligent feature in TradeMe. It writes the trade theses for your Compiler Top 10, generates the Morning Brief, powers Deep Dive analysis, and classifies news sentiment. Without it, TradeMe is still a powerful scanner — but the AI layer that makes it unique requires this key.

Trade Theses Morning Brief Deep Dive AI Sentiment Classification Conviction Grading
Without Claude: No AI-written trade theses. No Morning Brief. No AI-powered Deep Dive analysis. No sentiment classification. The Compiler still ranks stocks based on quantitative modules, but the written analysis that explains WHY a setup is ranked won't be generated.
Pricing: Pay-per-use. Load credits and pay per token. Typical usage: ~$5–15/month
Model used: claude-3-5-sonnet (latest)
How to get key: Create account → API Keys → Generate new key → Copy into TradeMe Settings
Sign up at console.anthropic.com →

Free APIs That Make a Difference

These APIs provide substantial functionality at zero cost. Each one expands your data coverage without adding to your monthly bill.

📈 Tiingo Free Tier Available

Adjusted end-of-day stock bars, IEX intraday bars, live top-of-book prices, and financial news. Serves as Fallback #1 when FMP is unavailable.

Free limits: 50 unique symbols/hr, 1,000 requests/hr
Priority: Fallback #1 for stock prices and intraday data (behind FMP)
Sign up at tiingo.com →

📰 Finnhub Free

Stock headlines, earnings calendar, and company sentiment scores. A solid supplementary news source.

Free limits: 60 API calls/minute
Priority: #2 in the news priority chain (behind FMP)
Sign up at finnhub.io →

🏛️ FRED Free

The gold standard for U.S. economic data. CPI, GDP, unemployment rate, Treasury yields, Fed funds rate. Powers TradeMe's macro analysis modules.

Free limits: Generous — more than enough for TradeMe
Priority: #1 in the macro/economic data chain
Get your FRED key →

🗞️ NewsAPI Free

Aggregates financial news from major outlets — Reuters, CNBC, WSJ, Bloomberg, and more. Broadest news coverage of any single source.

Free limits: 100 requests/day
Priority: #4 in the news chain
Sign up at newsapi.org →

📉 Alpha Vantage Free

Supplementary news sentiment analysis and economic indicators. Lower priority but adds depth to the data stack.

Free limits: 25 requests/day
Priority: #5 in the news chain
Get your Alpha Vantage key →

📋 SEC EDGAR Free — No Key Needed

Real-time SEC filings direct from the source. Form 8-K (material events) and Form 4 (insider trades) via RSS feed. No API key required — TradeMe connects automatically.

Priority: #3 in the news chain
Learn about SEC EDGAR →

📊 yfinance Free — Always On — Built In

Stock prices, daily historical data, options chains, and basic earnings data. This is TradeMe's safety net — it's always active, requires no key, and cannot be disabled. Critically, it is the ONLY source for options chain data in the entire system.

Setup: None required. Built into TradeMe and runs automatically.

📡 RSS Feeds Free — No Key Needed

Aggregated news from Reuters, CNBC, MarketWatch, Financial Times, Yahoo Finance, Seeking Alpha, and Google News. The final fallback in the news chain — ensures you always have news coverage.

Setup: Automatically active. No setup required.

Always Have Data

TradeMe doesn't depend on any single API. When your primary source is unavailable, slow, or disabled, the system automatically tries the next source in the chain.

Stock Prices FMP Tiingo yfinance
Intraday Bars FMP Tiingo yfinance
Options Chains yfinance (only source — always available)
News FMP Finnhub SEC EDGAR NewsAPI Alpha Vantage RSS
Earnings FMP Finnhub yfinance
Macro / Economic FRED FMP
AI Analysis Anthropic Claude (no fallback — unique capability)
This means even if you're running on free APIs only, you have multiple layers of redundancy. And if you're running the full premium stack, you have the fastest, deepest data available with automatic failover.

Pick Your Level

TradeMe scales with you. Start free, add APIs as you grow.

Free Stack
$0/mo
Zero Ongoing Cost
  • Stock prices & daily history
  • Options chains (yfinance)
  • Financial news from 6+ sources
  • Earnings calendars
  • Macro data (Treasury yields, CPI, GDP)
  • SEC filings (8-K, Form 4)
  • AI-written theses
  • Real-time intraday bars
  • Fundamentals & insider trades
AI-Powered
~$5–15/mo
Free Stack + Claude AI
  • Everything in Free Stack
  • AI-written trade theses
  • Morning Brief
  • Deep Dive AI analysis
  • Sentiment classification
  • Real-time intraday data
  • Full fundamentals
  • Insider / congressional trades
Full Stack
~$35–45/mo
The Complete Experience
  • Everything in AI-Powered
  • True real-time quotes (45s refresh)
  • 1-minute intraday bars
  • Full company fundamentals
  • Earnings transcripts
  • Insider & congressional trades
  • Institutional holdings
  • Analyst estimates
  • Server-side technical indicators
This is what we built TradeMe for.

TradeMe includes a crypto module architecture with support for the following APIs. These are disabled by default and intended for advanced users. Crypto scanning features are in active development.

CoinGecko

Market cap, supply, sentiment, trending coins

Free Tier
coingecko.com →

CCXT (Binance/Bybit)

OHLCV, order books, funding rates, open interest

Free
docs.ccxt.com →

Glassnode

On-chain analytics: exchange flows, SOPR, NUPL

Premium
glassnode.com →

CoinGlass

Funding rates, open interest, liquidation heatmap

Premium
coinglass.com →

Whale Alert

Real-time large on-chain transactions (>$500K)

Free Tier
whale-alert.io →

LunarCrush

Social volume, Galaxy Score, Twitter/Reddit sentiment

Premium
lunarcrush.com →

Santiment

Social volume, dev activity, whale transactions

Premium
santiment.net →

CryptoQuant

Exchange reserves, miner flows

Premium
cryptoquant.com →

Ready to Connect?

1

Open Settings

Open TradeMe → Settings → API Keys

2

Paste Your Keys

Paste each key into its field

3

Encrypted & Local

Keys are encrypted and stored locally on your machine — we never see them

4

Auto-Detect

The system automatically detects which APIs are available and uses the best source