agenthc-market-intelligence

AI 代理的市场数据 API。股票、固定收益、加密货币和宏观经济。比特币闪电小额支付。

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

---

## 中文说明

# 股票市场情报

面向 AI 代理和开发者的市场数据 API。覆盖股票、固定收益、加密货币和宏观经济。通过 webhook 和 Discord 提供实时提醒。支持比特币闪电网络小额支付。由 @traderhc 构建。

## 安装设置

### 面向 AI 代理

```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')
```

免费，无需 KYC，无需信用卡。查询任意免费端点：

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

### 交互式设置

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

### 非交互式（CI/脚本）

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

## 可用内容

| 层级 | 覆盖范围 | 费用 |
|------|----------|------|
| **免费** | 市场概览、教育内容 | $0 |
| **高级** | 股票、固定收益、宏观经济、加密货币、波动率 | 约 $50/月 |
| **机构级** | 完整平台访问及高级分析 | 约 $500/月 |

完整端点目录请参阅 [api.traderhc.com/docs](https://api.traderhc.com/docs)。

## 代理优化格式

使用 `format=agent` 获取可执行的信号：

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

## 紧凑格式

使用 `format=compact` 以减少 token 消耗：

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

## 批量查询（高级及以上）

在单个请求中查询多个端点：

```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 '.'
```

## 提醒

通过 webhook 或 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 '.'
```

## 闪电网络支付（L402）

用于无需注册的按请求付费：

1. 在不带认证的情况下请求高级端点
2. 收到带闪电网络发票的 402 响应
3. 支付该发票（任意闪电网络钱包）
4. 使用 `Authorization: L402 <macaroon>:<preimage>` 重新发起请求

## 定价

| 层级 | 速率 | 费用 |
|------|------|------|
| 免费 | 10/分钟，100/天 | $0 |
| 高级 | 60/分钟，5,000/天 | 约 $50/月（50K sats） |
| 机构级 | 120/分钟，50,000/天 | 约 $500/月（500K sats） |

通过比特币闪电网络支付。即时结算，无需 KYC。

## 免责声明

所有数据和分析仅供教育和参考之用。并非财务建议。本服务并非注册投资顾问。请始终自行研究。