tastytrade

tastytrade REST API

The core REST API for tastytrade provides programmatic access to accounts, customer information, balances, positions, transactions, orders, instruments, option chains, market data, watchlists, margin requirements, quote alerts, risk parameters, backtesting, and symbol search. All responses are JSON. Session tokens expire after 15 minutes; OAuth 2.0 long-lived refresh tokens are also available for partner integrations.

Documentation GitHub OpenAPI

Documentation

https://developer.tastytrade.com/

https://developer.tastytrade.com/oauth/

https://developer.tastytrade.com/basic-api-usage/

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/rate-limits/rate-limits.yml

Specifications

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/account-status.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/accounts-and-customers.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/backtesting.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/balances-and-positions.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/instruments.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/margin-requirements.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/market-data.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/market-metrics.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/market-sessions.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/net-liquidating-value-history.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/orders.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/quote-alerts.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/risk-parameters.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/symbol-search.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/transactions.json

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/openapi/watchlists.json

Other Resources

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/json-ld/tastytrade-api.jsonld

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/vocabulary/tastytrade-vocabulary.json

https://developer.tastytrade.com/sandbox/

PostmanCollection

https://www.postman.com/tastytradeapi/tastytrade-api/documentation/p5jnvzh/tastytrade-api

https://developer.tastytrade.com/api-overview/

https://raw.githubusercontent.com/api-evangelist/tastytrade/refs/heads/main/plans/plans.yml

OpenAPI Specification

{
  "info": {
    "title": "Account Status",
    "version": "7.1.0"
  },
  "swagger": "2.0",
  "produces": [
    "application/json"
  ],
  "host": "api.tastyworks.com",
  "tags": [
    {
      "name": "trading-status",
      "description": "Allows an API client to request information about the basic trade status of an account. \\\n                          This includes information about the strategies an account can trade."
    }
  ],
  "paths": {
    "/accounts/{account_number}/trading-status": {
      "get": {
        "description": "Returns current trading status for an account.",
        "produces": [
          "application/json"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "account_number",
            "type": "integer",
            "format": "int32",
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Returns current trading status for an account.",
            "schema": {
              "$ref": "#/definitions/TradingStatus"
            }
          }
        },
        "tags": [
          "trading-status"
        ],
        "operationId": "getAccountsAccountNumberTradingStatus"
      }
    }
  },
  "definitions": {
    "TradingStatus": {
      "type": "object",
      "properties": {
        "id": {
          "description": "",
          "type": "integer",
          "format": "int32"
        },
        "account-number": {
          "description": "",
          "type": "string"
        },
        "are-deep-itm-carry-options-enabled": {
          "description": "",
          "type": "boolean"
        },
        "are-far-otm-net-options-restricted": {
          "description": "",
          "type": "boolean"
        },
        "are-options-values-restricted-to-nlv": {
          "description": "",
          "type": "boolean"
        },
        "are-single-tick-expiring-hedges-ignored": {
          "description": "",
          "type": "boolean"
        },
        "autotrade-account-type": {
          "description": "",
          "type": "string"
        },
        "clearing-account-number": {
          "description": "",
          "type": "string"
        },
        "clearing-aggregation-identifier": {
          "description": "",
          "type": "string"
        },
        "cmta-override": {
          "description": "",
          "type": "integer",
          "format": "int32"
        },
        "day-trade-count": {
          "description": "",
          "type": "integer",
          "format": "int32"
        },
        "enhanced-fraud-safeguards-enabled-at": {
          "description": "",
          "type": "string",
          "format": "date-time"
        },
        "equities-margin-calculation-type": {
          "description": "",
          "type": "string"
        },
        "ext-crm-id": {
          "description": "",
          "type": "string"
        },
        "fee-schedule-name": {
          "description": "",
          "type": "string"
        },
        "futures-margin-rate-multiplier": {
          "description": "",
          "type": "number",
          "format": "double"
        },
        "has-intraday-equities-margin": {
          "description": "",
          "type": "boolean"
        },
        "is-aggregated-at-clearing": {
          "description": "",
          "type": "boolean"
        },
        "is-ascend-event-contracts-enabled": {
          "description": "",
          "type": "boolean"
        },
        "is-closed": {
          "description": "",
          "type": "boolean"
        },
        "is-closing-only": {
          "description": "",
          "type": "boolean"
        },
        "is-cryptocurrency-closing-only": {
          "description": "",
          "type": "boolean"
        },
        "is-cryptocurrency-enabled": {
          "description": "",
          "type": "boolean"
        },
        "is-equity-offering-closing-only": {
          "description": "",
          "type": "boolean"
        },
        "is-equity-offering-enabled": {
          "description": "",
          "type": "boolean"
        },
        "is-frozen": {
          "description": "",
          "type": "boolean"
        },
        "is-full-equity-margin-required": {
          "description": "",
          "type": "boolean"
        },
        "is-futures-closing-only": {
          "description": "",
          "type": "boolean"
        },
        "is-futures-enabled": {
          "description": "",
          "type": "boolean"
        },
        "is-futures-intra-day-enabled": {
          "description": "",
          "type": "boolean"
        },
        "is-in-day-trade-equity-maintenance-call": {
          "description": "",
          "type": "boolean"
        },
        "is-in-margin-call": {
          "description": "",
          "type": "boolean"
        },
        "is-non-retail": {
          "description": "",
          "type": "boolean"
        },
        "is-pattern-day-trader": {
          "description": "",
          "type": "boolean"
        },
        "is-portfolio-margin-enabled": {
          "description": "",
          "type": "boolean"
        },
        "is-risk-reducing-only": {
          "description": "",
          "type": "boolean"
        },
        "is-roll-the-day-forward-enabled": {
          "description": "",
          "type": "boolean"
        },
        "is-small-notional-futures-intra-day-enabled": {
          "description": "",
          "type": "boolean"
        },
        "options-level": {
          "description": "",
          "type": "string"
        },
        "pdt-reset-on": {
          "description": "",
          "type": "string",
          "format": "date"
        },
        "short-calls-enabled": {
          "description": "",
          "type": "boolean"
        },
        "small-notional-futures-margin-rate-multiplier": {
          "description": "",
          "type": "number",
          "format": "double"
        },
        "updated-at": {
          "description": "",
          "type": "string",
          "format": "date-time"
        }
      },
      "description": "TradingStatus model"
    }
  }
}