TradeEasy API

Header format

Include this header on every request:

X-API-Key: te_pub_b3f9a17c92ef…

Storing your key

Store your key in an environment variable — never hard-code it.

# .env
TRADEEASY_API_KEY=te_pub_b3f9a17c92ef…

How it works

• Cached & fresh200 — data returned
• Cached but stale200 — meta.stale=true + auto-refresh
• Not cached yet202 — queued, poll for status
• Unknown ticker404 SYMBOL_NOT_FOUND

Triggering analysis adds the asset to your watchlist (counted against your per-tier cap) and returns immediately — never blocking while analysis runs. Freshness window: 120 minutes.

202 Accepted response

A cache miss returns 202 with a job id, a poll URL and a Retry-After header.

HTTP/1.1 202 Accepted
Retry-After: 8

{
  "success": true,
  "data": {
    "status": "pending",
    "symbol": "NVDA",
    "job_id": "odj_9f1c…",
    "poll_url": "/public/v1/analysis/status/odj_9f1c…",
    "result_url": "/public/v1/sentiment/NVDA",
    "retry_after": 8
  },
  "meta": { "accepted": true, "retry_after": 8 }
}

Stale data refresh

When cached analysis is older than the freshness window we return it immediately with meta.stale=true (plus meta.age_seconds and meta.refreshed_at) and kick a background refresh — so your next call returns fresh data. You are never blocked waiting.

Per-tier watchlist caps

Each new asset you analyze is added to your watchlist. Adding a new asset beyond your cap returns 403 WATCHLIST_LIMIT_REACHED — remove an asset to continue. There is no per-call analysis credit; the scheduled pipeline keeps tracked assets fresh.

• Premium50 assets
• Annual200 assets
• Lifetime500 assets

Signature verification

Verify webhook authenticity using the X-TradeEasy-Signature header and your webhook secret.

import hmac, hashlib

def verify(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(expected, signature)

Retry policy

Failed deliveries are retried with exponential backoff — up to 4 attempts, with a 10s timeout per attempt. After 10 consecutive failures the subscription is automatically disabled.

Attempt 1 →  immediate
Attempt 2 →  after 1s
Attempt 3 →  after 5s
Attempt 4 →  after 30s
backoff schedule: 1s · 5s · 30s · 300s
─── auto-disabled after 10 consecutive failures ───

Success envelope

{
  "success": true,
  "data": { … },
  "meta": {
    "timestamp": "2026-05-17T14:30:00Z",
    "request_id": "req_8f2a9b4c"
  }
}

Error envelope

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 12s.",
    "status": 429
  }
}