REST API Reference

Base URL

All paths in this reference are relative to the base URL. HTTPS only.

Authentication

Open Settings → AI and API to copy your API key, then send it as a Bearer token on every request:

• Missing or malformed header → 401 UNAUTHORIZED.
• Unknown token → 403 FORBIDDEN.
• Plan-gated endpoint without the right tier → 403 PLAN_REQUIRED.
• Over daily quota → 429 RATE_LIMIT_EXCEEDED plus Retry-After and X-RateLimit-* headers.

The same token drives TradingView webhooks. Keep it secret and rotate from Settings if it leaks.

Rate limits

Quotas are per-token, per-day (UTC). Counters reset at 00:00 UTC.

Response shape

Every endpoint returns the same envelope: ok: true with a data object on success, ok: false with a coded error on failure.

{
  "ok": true,
  "data": { ... }
}

{
  "ok": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "..."
  }
}

Quick start

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://www.tradingwizard.ai/api/v1/account

Endpoints