YN FINANCE API · v1.0 · REST · JSON

Build on the intelligence
Wall Street keeps private.

Congressional trades. Smart money signals. Earnings forensics. AI analysis. Plug it into any app in minutes.

ENDPOINTS
All endpoints return real data from Finnhub and Gemini AI. Replace yn_live_YOUR_KEY with your actual key.
DESCRIPTION
Live congressional stock trades — fetched from House disclosure filings, enriched with real-time Finnhub prices and AI suspicion scoring.
DATA SOURCE
House Stock Watcher filings + Finnhub live prices + Gemini AI
QUERY PARAMS
?limit=20  (max 100)
?days=30   (max 365)
RESPONSE (real example)
{
  "trades": [{
    "representative": "Nancy Pelosi",
    "party": "D", "state": "CA",
    "ticker": "NVDA",
    "type": "purchase",
    "amount": "$250,001 - $500,000",
    "transaction_date": "2026-05-20",
    "current_price": 878.20,
    "price_change_pct": 2.4,
    "suspicion_score": 97   // 0-100
  }],
  "stats": {
    "total_this_year": 847,
    "most_active_rep": "Adam Schiff",
    "biggest_trade": "$500,001+",
    "total_reps": 73
  }
}
const res = await fetch(
  'https://ynfinance.org/api/v1/congress/trades?limit=10&days=30',
  { headers: { Authorization: 'Bearer yn_live_YOUR_KEY' } }
)
const { trades, stats } = await res.json()
// trades[0].representative, .ticker, .suspicion_score
AUTHENTICATION
Header (every request)
Authorization: Bearer yn_live_xxxx
Alternative header
x-api-key: yn_live_xxxx
Every response includes source, version, and timestamp fields. On error, check the error field and HTTP status code.
RATE LIMITS
Tier
Monthly
Per min
Price
Free
100
10
$0
Pro
10,000
60
$49/mo
Enterprise
∞
300+
Custom
Exceeded limit → 401 Unauthorized. Resets on the 1st of each month. Upgrade anytime from your dashboard above.