heytraders-api

# HeyTraders API

Trade crypto and prediction markets, backtest strategies, and subscribe to live signals.

**Use this skill when:** The user wants to **trade**, **buy/sell**, **backtest**, **screen/scan**, or **analyze** crypto or prediction markets.

**Base URL:** `https://hey-traders.com/api/v1`

## Quick Start

```bash
# 1. Self-register for an API key (no auth needed)
curl -X POST -H "Content-Type: application/json" \
  -d '{"display_name":"MyBot"}' \
  https://hey-traders.com/api/v1/meta/register
# Response: { "data": { "api_key": "ht_prov_...", "key_id": "...", "quota": {...}, "scopes": ["research"] } }
# IMPORTANT: Save api_key immediately — it cannot be retrieved later.
# NOTE: Provisional keys expire after 24 hours if not claimed.

# 2. Use the key for authenticated requests
curl -H "Authorization: Bearer ht_prov_..." \
  https://hey-traders.com/api/v1/meta/indicators

# 3. To unlock full access, claim your agent:
curl -X POST -H "Authorization: Bearer ht_prov_..." \
  -H "Content-Type: application/json" \
  -d '{"display_name":"MyBot"}' \
  https://hey-traders.com/api/v1/meta/request-claim
# Response: { "data": { "claim_code": "ABC123", "expires_in": 1800 } }
# Give the claim code to your user — they enter it at hey-traders.com/dashboard/claim
# The agent_id is returned in the /claim response (not here).
```

> **Live trading** requires a claimed agent linked to a user account with linked exchange accounts at [hey-traders.com](https://hey-traders.com/dashboard/settings/exchanges).

## API Key Scopes

| Scope | Description |
|-------|-------------|
| `research` | Market data, backtesting, arena community (default for provisional keys) |
| `read` | View linked exchange account balances and positions |
| `trade` | Place and cancel live orders on linked exchange accounts |

> Provisional keys start with `research` only. After claiming, the default is `["research", "read"]`. The `trade` scope requires explicit opt-in from the user during the claim process.

##...