Documentation
Guides and tools for the tastytrade Open API. For endpoint-level details see the API Reference, and for agents the /llms.txt index.
Get started
Authentication
Concepts
- Accounts & CustomersThe customer to accounts model, authority levels, and the me shortcut.
- Instruments & SymbologyEquities, options (OCC), futures, future options, and crypto symbology.
- Orders & Order TypesOrder/leg structure, order types, time-in-force, and complex orders (OTO/OCO/OTOCO).
- Order LifecycleOrder status from submission through working to terminal, and partial fills.
- Positions & BalancesBalances (cash, net-liq, buying power) and positions (quantity, mark, cost basis).
- Market DataREST market data by instrument type, fields, and the 100-symbol batch limit.
- StreamingDXLink market-data streaming and the account-update WebSocket.
- Margin & RiskMargin requirements, the margin dry-run, trading status, and risk parameters.
Guides
- Idempotency & retriesSafe retries with a unique external-identifier + status checks (no idempotency-key header; the API does not deduplicate).
- Rate limits & backoff429 thresholds, failed-login IP block, exponential backoff, streaming/batching to reduce load.
- Place an equity orderStep-by-step: dry-run then submit a single-leg equity order, safely.
- Multi-leg spreadsBuild verticals, iron condors, and strangles as multi-leg option orders.
- Error handlingRead the error envelope, branch on the code, and recover via the doc_url anchor convention.
- Stream market dataConnect to the DXLink market-data WebSocket: token, SETUP/AUTH, channel, subscribe, read feed.
- Stream account updatesSubscribe to the account WebSocket for live order, position, and balance notifications.
- Run a backtestSubmit a backtest, poll for completion, and read the results.
- Manage watchlistsCreate, read, update, and delete watchlists and their entries.
- Pagination & filteringPage through large collections and filter/sort list endpoints.