Skip to content
Sarna

Concepts

Conceptual explanations of how the Sarna API models brokerage operations — authentication tiers, the trading workflow, account structure, risk controls, and error patterns.

The conceptual material lives in the Guides section, alongside the task-oriented walkthroughs. Each guide opens with the concept before showing how to put it into practice.

  • Authentication — Sandbox Bearer tokens, production HMAC, the two-tier permission model
  • Trading Workflow — The canonical Quote → Order → Fill → Positions flow, order types, sign conventions
  • Account Structure — Accounts, subaccounts, account types, trading levels
  • Risk Management — Margin, buying power, pre-trade rules
  • Error Handling — Response envelope, error codes, retry strategies

Architecture diagrams and sequence flows will be added in a later release.