Base URL
Authentication
All endpoints (except/health) require a Bearer token:
Response format
Every response follows a consistent envelope:Prefixed IDs
Every entity has a type-prefixed ID for easy identification:| Entity | Prefix | Example |
|---|---|---|
| Trader | trd_ | trd_0xabc123def456 |
| Market | mkt_ | mkt_0x789condition |
| Whale trade | wt_ | wt_12345 |
| Radar flag | rf_ | rf_67890 |
| Request | req_ | req_550e8400 |
Rate limits
100 requests per minute per user (sliding window). Check response headers:| Header | Description |
|---|---|
X-RateLimit-Limit | Max requests per window |
X-RateLimit-Remaining | Requests remaining |
X-RateLimit-Reset | Unix timestamp when window resets |
Retry-After | Seconds to wait (only on 429) |