SoarSoar
For developers

The Soar API

Programmatic access to live signals and on-demand analysis. Bearer-token auth, JSON responses, generous rate limits per tier.

Auth

Authentication

Every API request needs an Authorization: Bearer SOAR_API_KEY header. Generate a key from /dashboard/api-keys — Analyst plan and above. Keys are scoped to your account; rate limit is per-key.

curl https://soar.trade/api/v1/cards \
  -H "Authorization: Bearer YOUR_API_KEY"
Endpoints

What you can call

GET/api/v1/cardsAnalyst+
Returns the current session's published trade cards. Includes asset, direction, entry zone, T1, T2, stop, conviction, and the plain-English thesis.
POST/api/v1/analysisAnalyst+
Triggers an on-demand analysis (Light / Medium / Full tier) on any ticker. Returns the same payload shape as the dashboard's report viewer.
Rate limits

What you get per tier

All limits are per-key, per-month. Burst allowance is 10 req / sec across all endpoints.

PlanCalls / month
Analyst5
Pro API500
Pro Plus API5,000
EnterpriseCustom
Best practices

Things to know

  • Cards endpoint refreshes every session — caching responses up to 30 min is safe.
  • On-demand analysis is async; poll the response's job_id for completion.
  • All timestamps are UTC ISO-8601.
  • The API never returns broker keys, customer PII, or other Soar accounts' data.
  • HTTP 429 means you've hit the per-second burst — back off + retry with jitter.
See also

Related help

Need higher limits or custom endpoints? Open a ticket — Enterprise plans include dedicated rate limits, SLAs, and direct engineering contact.