Stock Market Intelligence

Market data API for AI agents and developers. Covers equities, fixed income, crypto, and macro. Real-time alerts via webhook and Discord. Bitcoin Lightning micropayments. Built by @traderhc.

Setup

For AI Agents

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

Free, no KYC, no credit card. Query any free endpoint:

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

Interactive Setup

bash scripts/setup.sh

Non-Interactive (CI/scripts)

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

What's Available

| Tier | Coverage | Cost | |------|----------|------| | Free | Market overview, educational content | $0 | | Premium | Equities, fixed income, macro, crypto, volatility | ~$50/mo | | Institutional | Full platform access with advanced analytics | ~$500/mo |

See api.traderhc.com/docs for the full endpoint catalog.

Agent-Optimized Format

Use format=agent for actionable signals:

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

Compact Format

Use format=compact for reduced token usage:

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

Batch Queries (Premium+)

Query multiple endpoints in one request:

curl -s -X POST "https://api.traderhc.com/api/v1/data/batch" \
  -H "X-API-Key: $AGENTHC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"endpoints": ["overview", "fixed_income", "macro"]}' | jq '.'

Alerts

Subscribe to real-time market alerts via webhook or Discord:

# List available alert types
curl -s "https://api.traderhc.com/api/v1/alerts" \
  -H "X-API-Key: $AGENTHC_API_KEY" | jq '.alerts'

# Subscribe via webhook
curl -s -X POST "https://api.traderhc.com/api/v1/alerts/subscribe" \
  -H "X-API-Key: $AGENTHC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "market_events", "callback_url": "https://your-agent.com/webhook"}' | jq '.'

Lightning Payment (L402)

For per-request payment without registration:

1. Request a premium endpoint without auth
2. Receive 402 response with Lightning invoice
3. Pay the invoice (any Lightning wallet)
4. Re-request with Authorization: L402 <macaroon>:<preimage>

Pricing

| Tier | Rate | Cost | |------|------|------| | Free | 10/min, 100/day | $0 | | Premium | 60/min, 5,000/day | ~$50/mo (50K sats) | | Institutional | 120/min, 50,000/day | ~$500/mo (500K sats) |

Payment via Bitcoin Lightning Network. Instant settlement, no KYC.

Disclaimer

All data and analysis is for educational and informational purposes only. Not financial advice. Not a registered investment advisor. Always do your own research.