Stock Market Intelligence

    primaryEnv: "AGENTHC_API_KEY"
license: UNLICENSED
---

# 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

```bash
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:

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

### Interactive Setup

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

### Non-Interactive (CI/scripts)

```bash
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](https://api.traderhc.com/docs) for the full endpoint catalog.

## Agent-Optimized Format

Use `format=agent` for actionable signals:

```bash
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:

```bash
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:

```bash
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:

```bash
# 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.