tradekix

通过 Tradekix API 查询金融市场数据 — 股票价格、加密货币、外汇、指数、市场新闻、收益、经济事件、国会交易和社会情绪。当用户询问市场、股票价格、交易数据、经济日历或财经新闻时使用。还处理 API 密钥注册和升级到 Pro。

## 概述（中文）

通过 Tradekix API 查询金融市场数据 — 股票价格、加密货币、外汇、指数、市场新闻、收益、经济事件、国会交易和社会情绪。当用户询问市场、股票价格、交易数据、经济日历或财经新闻时使用。还处理 API 密钥注册和升级到 Pro。

## 原文

# Tradekix

Financial data API for AI agents. Free tier: 10 calls/day.

## Setup

Check for existing config:
```bash
cat ~/.config/tradekix/config.json 2>/dev/null
```

If no config exists, sign up automatically:
```bash
bash SKILL_DIR/scripts/tradekix.sh signup --name "AGENT_NAME" --email "AGENT_EMAIL"
```

This stores the API key in `~/.config/tradekix/config.json`.

## Usage

Run via the wrapper script. All commands auto-load the API key from config.

```bash
# Market overview (stocks, crypto, forex, commodities)
bash SKILL_DIR/scripts/tradekix.sh market

# Specific stock/crypto prices
bash SKILL_DIR/scripts/tradekix.sh prices AAPL,TSLA,BTC

# Global indices
bash SKILL_DIR/scripts/tradekix.sh indices

# Forex rates
bash SKILL_DIR/scripts/tradekix.sh forex

# Market news summaries
bash SKILL_DIR/scripts/tradekix.sh news

# Latest alerts
bash SKILL_DIR/scripts/tradekix.sh alerts

# Economic calendar
bash SKILL_DIR/scripts/tradekix.sh economic

# Earnings calendar
bash SKILL_DIR/scripts/tradekix.sh earnings

# Social sentiment
bash SKILL_DIR/scripts/tradekix.sh sentiment

# Market tweets
bash SKILL_DIR/scripts/tradekix.sh tweets

# Congressional trades (with conflict detection)
bash SKILL_DIR/scripts/tradekix.sh trades

# Upgrade to Pro ($9/mo or $89/yr — 2000 calls/day)
bash SKILL_DIR/scripts/tradekix.sh upgrade monthly

# Revoke API key
bash SKILL_DIR/scripts/tradekix.sh revoke
```

## Endpoint Selection Guide

| User asks about... | Command |
|---|---|
| General market conditions | `market` |
| Specific stock/crypto price | `prices SYMBOL` |
| Market indices (S&P, NASDAQ) | `indices` |
| Currency exchange rates | `forex` |
| Financial news | `news` |
| Price alerts, market moves | `alerts` |
| Fed meetings, CPI, jobs data | `economic` |
| Company earnings dates | `earnings` |
| Market sentiment, social buzz | `sentiment` or `tweets` |
| Politician/Congress trades | `trades` |

## Response Format

All responses return `{"success":true,"data":{...},"meta":{...}}`. Parse `data` for results. Check `meta.rate_limit_remaining` to track usage.

## Rate Limits

- **Free:** 10 calls/day, 5/min
- **Pro:** 2,000 calls/day, 60/min ($9/mo or $89/yr)
- **Enterprise:** 50,000 calls/day — contact sales@tradekix.com

When rate limited (HTTP 429), check `Retry-After` header.

## Full API Reference

See [references/api-docs.md](references/api-docs.md) for complete endpoint documentation.