tastytradeDeveloper Docs

Release Notes

Changes to the API, newest first. See API versions for how to target a version with the Accept-Version header.

20261012

This release is for order-api only (the order endpoints). Order searches now require a start date, and customer live orders are now paginated. Order-api version 20250813 is deprecated and will be removed on or after 12 April 2027.

Breaking changes

  • GET /accounts/{account_number}/orders and GET /customers/{customer_id}/orders require start-date or start-at. Requests with neither return a 400.
  • GET /customers/{customer_id}/orders/live is paginated: per-page (default 100, maximum 200) and page-offset, with a top-level pagination block in the response. In 20250813 it is not paginated and returns every order in one response.

Migrating

  • Send Accept-Version: 20261012. A request with no Accept-Version header is currently served 20250813, the oldest order-api version, and does not get the changes above. Set the header explicitly rather than relying on the default.
  • Add start-date (YYYY-MM-DD) or start-at (ISO 8601) to order searches.
  • To list today's orders without a date range, use GET /accounts/{account_number}/orders/live. It returns orders from the current trading day, in any status rather than only Live, and accepts status (several values at once) and underlying-symbol filters.
  • Page through customer live orders. Fetch the first page, and only request more if you need them.

See Pagination and filtering and Orders.

20260629

Cryptocurrency trading has been disabled through the API until further notice.

20260211

Legacy /sessions authentication has been fully decommissioned. If you are still sending POST /sessions, your application is failing to log in. Switch to OAuth2 to restore access.

20250813

Response data is now paginated for:

  • GET /accounts/{account_number}/orders/live
{
  "data": {
    "items": [{}]
  },
  "pagination": {
    "per-page": 1000,
    "page-offset": 0,
    "item-offset": 0,
    "total-items": 25719,
    "total-pages": 26,
    "current-item-count": 1000
  }
}

See Pagination and filtering for how to walk the pages, and Orders for the endpoint itself.

Related