agenthc-market-intelligence

---
name: agenthc-market-intelligence
description: Real-time stock market data and trading intelligence API. 85 intelligence modules, 40 encoded intelligence skills, and 7 named alert packages — equities, bonds, crypto, bitcoin, macro economics, Fed policy, treasury yields, VIX, options flow, sector rotation, regime detection, and technical analysis. Finance data for AI agents with Bitcoin Lightning micropayments.
homepage: https://api.traderhc.com/docs
metadata:
  clawdbot:
    emoji: "📊"
    requires:
      env: ["AGENTHC_API_KEY"]
      bins: ["curl", "jq", "python3"]
    primaryEnv: "AGENTHC_API_KEY"
---

# Stock Market Intelligence

Institutional-grade market intelligence API for AI agents. 85 intelligence modules, 40 encoded intelligence skills, and 7 named alert packages covering equities, bonds, crypto, macro, Fed, liquidity, regime detection, alpha signals, options flow, and more. Free tier includes regime detection with transition probabilities. Real-time alerts via webhook and Discord. Bitcoin Lightning micropayments. Built by @traderhc.

## Setup

### For AI Agents (copy-paste, zero friction)

```bash
export AGENTHC_API_KEY=$(curl -s -X POST "https://api.traderhc.com/api/v1/agents/register" \
  -H "Content-Type: application/json" \
  -d '{"name": "MyAgent"}' | jq -r '.api_key')
```

That's it. One command. Free, no KYC, no credit card. Now query any free module:

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/market_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### For Humans (interactive setup)

```bash
bash scripts/setup.sh
```

Walks you through registration and prints your API key.

### Non-Interactive (CI/scripts)

```bash
export AGENTHC_API_KEY=$(bash scripts/setup.sh --auto)
```

## Free Modules (no payment required)

### Market Intelligence
Real-time market snapshot with institutional-grade regime detection. Includes S&P 500, VIX, treasury yields, DXY, commodities, Fear & Greed, and the full regime story — which of 12 market regimes we're in, confidence score, what's driving it, which regime is most likely next, and transition probabilities.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/market_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '{regime: .data.regime, confidence: .data.regime_confidence, signals: .data.regime_signals, next_likely: .data.regime_next_most_likely, transition_gap: .data.regime_transition_gap, implications: .data.regime_implications, vix: .data.vix, fear_greed: .data.fear_greed_index}'
```

Example response:
```json
{
  "regime": "goldilocks",
  "confidence": 0.473,
  "signals": ["Tight HY spreads", "ISM at 51.0 - moderate expansion"],
  "next_likely": "recovery",
  "transition_gap": 2.8,
  "implications": ["Reflation (25% probability)", "Melt Up (20% probability)", "Growth Scare (15% probability)"],
  "vix": 19.09,
  "fear_greed": 69
}
```

### Educational Content
Trading concepts, historical lessons, and market psychology frameworks.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/educational_content" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Polymarket Intelligence
Fed/FOMC prediction markets, recession odds, crypto price predictions, political/regulatory odds.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/polymarket_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### VIX Regime Intelligence
Historically-calibrated VIX regime classification (7 levels: ultra low → crisis) with 30-day forward SPX return expectations, mean-reversion probability, and vol-selling opportunity detection. Calibrated on 1990-2024 CBOE data.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/vix_regime_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

## Premium Modules (100 sats/query)

These require Premium tier. Upgrade with Lightning payment or use L402 per-request payment.

### Technical Analysis
RSI, MACD, Bollinger Bands, support/resistance, volume analysis for any ticker.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/technical_analysis?ticker=AAPL" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Bond Intelligence
Treasury yields, yield curve dynamics, credit spreads, duration risk.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/bond_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Fed Intelligence
Fed balance sheet, FOMC calendar, ISM PMI, yield curve analysis, RRP/repo, liquidity trends.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/fed_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Macro Intelligence
CPI, PCE, NFP, unemployment, M2, credit spreads, ISM Services, consumer sentiment, housing.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/macro_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Correlation Tracker
18+ cross-market correlation pairs with anomaly detection and regime classification.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/correlation_tracker" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Volatility Analyzer
VIX regime classification, term structure, VVIX, implied vs realized vol.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/volatility_analyzer" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Volatility Surface
VIX ecosystem (VIX, VIX9D, VIX3M, VIX6M, VVIX), term structure, skew analysis, vol regime detection.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/volatility_surface" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Crypto Intelligence
Bitcoin, Ethereum, BTC dominance, halving cycle, alt season detection, crypto Fear & Greed.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/crypto_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Options Intelligence
Options open interest, volume, gamma exposure from OCC public data (T+1).

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/options_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### CME FedWatch
Fed rate probability expectations from CME FedWatch proxy.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/cme_fedwatch" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

## Institutional Modules (500 sats/query)

### Alpha Signals
Systematic multi-factor signal composite: momentum, mean reversion, carry, value, volatility, flow, macro.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/alpha_signals" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Regime Engine
12 market regimes with transition probabilities, leading indicators, historical analogues.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/regime_engine" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Tail Risk Engine
Crisis detection with 12 crisis types, early warning indicators, historical playbooks, composite tail risk score.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/tail_risk_engine" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Liquidity Intelligence
Fed net liquidity (Balance Sheet - TGA - RRP), liquidity regime, bank stress signals.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/liquidity_intelligence" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Credit Cycle
HY/IG/BBB/CCC spreads, lending standards, default indicators, credit cycle phase, financial conditions.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/credit_cycle" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

### Institutional Positioning
CFTC COT data, AAII sentiment, NAAIM exposure, put/call ratios, crowded trade detection.

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/institutional_positioning" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.data'
```

## Agent-Optimized Format

For AI agents, use `format=agent` to get actionable signals with direction, confidence, urgency, and delta tracking:

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/market_intelligence?format=agent" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.signals'
```

Response includes:
- `signals.direction` — bullish/bearish/neutral/mixed
- `signals.confidence` — 0.0 to 1.0
- `signals.urgency` — low/medium/high/critical
- `signals.actionable` — true if action recommended
- `suggested_actions` — related modules to query next
- `delta` — what changed since your last query

## Compact Format (Token-Efficient)

Use `format=compact` for 60% fewer tokens in your context window:

```bash
curl -s "https://api.traderhc.com/api/v1/intelligence/market_intelligence?format=compact" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.'
```

## Batch Queries (Premium+)

Query multiple modules in one request:

```bash
curl -s -X POST "https://api.traderhc.com/api/v1/intelligence/batch" \
  -H "X-API-Key: $AGENTHC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"modules": ["market_intelligence", "bond_intelligence", "fed_intelligence"]}' | jq '.'
```

## Alert Packages

Named, curated alert products that deliver enriched market intelligence via **webhook** (AI agents) or **Discord** (human traders). Each alert includes signal data, regime context, positioning implications, affected tickers, and what to watch next. All 7 packages are live with 9 independent event scanners running every 120 seconds.

### List Available Packages

```bash
curl -s "https://api.traderhc.com/api/v1/alert-packages" | jq '.packages'
```

### Subscribe to a Package

```bash
# Webhook delivery (for AI agents)
curl -s -X POST "https://api.traderhc.com/api/v1/alert-packages/regime_shift/subscribe" \
  -H "X-API-Key: $AGENTHC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"delivery_channels": ["webhook"], "callback_url": "https://mybot.example.com/alerts"}' | jq '.'

# Discord delivery (for human traders)
curl -s -

... (truncated)