TradeStation Market Data API

openapi: 3.2.0
info:
  title: TradeStation Market Data API
  description: The TradeStation API is a collection of RESTful brokerage and market data services used to build trading applications for stocks, options, futures, and cryptocurrency.
  version: '3.0'
  contact:
    name: TradeStation API Support
    url: https://api.tradestation.com/docs/
  termsOfService: https://www.tradestation.com/important-information/
servers:
- url: https://api.tradestation.com
  description: Production Server
- url: https://sim-api.tradestation.com
  description: Simulator Server (Paper Trading)
security:
- oauth2AuthCode: []
tags:
- name: Market Data
  description: Access real-time and historical market data including quotes, bar charts, symbol information, symbol lists, and cryptocurrency pairs.
paths:
  /v3/marketdata/quotes/{symbols}:
    get:
      operationId: getQuotes
      summary: Get quotes
      description: Retrieves real-time quote snapshots for one or more symbols. Returns current bid, ask, last price, volume, and other quote data fields. Supports stocks, options, futures, and cryptocurrency symbols.
      tags:
      - Market Data
      parameters:
      - $ref: '#/components/parameters/Symbols'
      responses:
        '200':
          description: Successfully retrieved quotes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QuotesResponse'
        '400':
          description: Invalid symbol format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v3/marketdata/barcharts/{symbol}:
    get:
      operationId: getBars
      summary: Get bar chart data
      description: Retrieves historical bar chart data (OHLC) for a given symbol. Supports multiple intervals and units including minute, daily, weekly, and monthly bars. Returns open, high, low, close prices along with volume and timestamp information.
      tags:
      - Market Data
      parameters:
      - name: symbol
        in: path
        required: true
        description: The symbol to retrieve bar chart data for.
        schema:
          type: string
      - name: interval
        in: query
        description: The interval for each bar. For minute bars, valid values are 1-1440. For daily, weekly, and monthly bars, use 1.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 1440
      - name: unit
        in: query
        description: The unit of time for the bar interval.
        required: false
        schema:
          type: string
          enum:
          - Minute
          - Daily
          - Weekly
          - Monthly
      - name: barsBack
        in: query
        description: Number of bars to retrieve going back from the last date.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 57600
      - name: firstDate
        in: query
        description: The start date for bar data retrieval.
        required: false
        schema:
          type: string
          format: date-time
      - name: lastDate
        in: query
        description: The end date for bar data retrieval.
        required: false
        schema:
          type: string
          format: date-time
      - name: sessionTemplate
        in: query
        description: The session template to use for filtering bar data. Controls which trading session data to include.
        required: false
        schema:
          type: string
          enum:
          - USEQPre
          - USEQPost
          - USEQPreAndPost
          - Default
      responses:
        '200':
          description: Successfully retrieved bar chart data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BarsResponse'
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Symbol not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v3/marketdata/symbols/{symbols}:
    get:
      operationId: getSymbols
      summary: Get symbol details
      description: Retrieves detailed symbol information for one or more symbols. Returns symbol metadata including description, exchange, category, currency, point value, and contract specifications.
      tags:
      - Market Data
      parameters:
      - $ref: '#/components/parameters/Symbols'
      responses:
        '200':
          description: Successfully retrieved symbol details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SymbolsResponse'
        '400':
          description: Invalid symbol format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /v3/marketdata/symbollists/cryptopairs/symbolnames:
    get:
      operationId: getCryptoPairs
      summary: Get cryptocurrency pairs
      description: Retrieves the list of available cryptocurrency trading pairs. Returns symbol names for all supported crypto pairs on the TradeStation platform.
      tags:
      - Market Data
      responses:
        '200':
          description: Successfully retrieved cryptocurrency pairs
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CryptoPairsResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      description: Standard error response returned by the TradeStation API.
      properties:
        StatusCode:
          type: integer
          description: HTTP status code of the error.
        Message:
          type: string
          description: Human-readable description of the error.
        TraceId:
          type: string
          format: uuid
          description: Unique trace identifier for debugging and support purposes.
    Bar:
      type: object
      description: A single OHLC bar representing price activity over a time interval.
      properties:
        High:
          type: number
          format: double
          description: The highest price during the bar interval.
        Low:
          type: number
          format: double
          description: The lowest price during the bar interval.
        Open:
          type: number
          format: double
          description: The opening price of the bar interval.
        Close:
          type: number
          format: double
          description: The closing price of the bar interval.
        Volume:
          type: integer
          description: The total volume during the bar interval.
        TimeStamp:
          type: string
          format: date-time
          description: The timestamp for the start of the bar interval.
        TotalTicks:
          type: integer
          description: The total number of ticks during the bar interval.
        UpTicks:
          type: integer
          description: The number of up ticks during the bar interval.
        DownTicks:
          type: integer
          description: The number of down ticks during the bar interval.
    BarsResponse:
      type: object
      description: Response containing bar chart data for a symbol.
      properties:
        Bars:
          type: array
          description: List of OHLC bars.
          items:
            $ref: '#/components/schemas/Bar'
    SymbolsResponse:
      type: object
      description: Response containing detailed symbol information.
      properties:
        Symbols:
          type: array
          description: List of symbol details.
          items:
            $ref: '#/components/schemas/Symbol'
    Symbol:
      type: object
      description: Detailed symbol information and metadata.
      properties:
        Name:
          type: string
          description: The symbol name or ticker.
        Description:
          type: string
          description: A human-readable description of the symbol.
        Exchange:
          type: string
          description: The exchange where the symbol is listed.
        ExchangeID:
          type: integer
          description: The numeric exchange identifier.
        Category:
          type: string
          description: The category of the symbol such as Stock, Option, Future, or Forex.
        Currency:
          type: string
          description: The currency the symbol is denominated in.
          enum:
          - USD
          - EUR
          - CAD
          - GBP
          - JPY
        Country:
          type: string
          description: The country where the symbol is listed.
        PointValue:
          type: number
          format: double
          description: The dollar value of a single point move.
        MinMove:
          type: number
          format: double
          description: The minimum price movement.
        Root:
          type: string
          description: The root symbol for options and futures.
        Underlying:
          type: string
          description: The underlying symbol for options.
        StrikePrice:
          type: number
          format: double
          description: The strike price for option symbols.
        ExpirationDate:
          type: string
          format: date
          description: The expiration date for option and futures symbols.
        OptionType:
          type: string
          description: The option type for option symbols.
          enum:
          - Call
          - Put
        FutureType:
          type: string
          description: The futures type classification.
    Quote:
      type: object
      description: Real-time quote data for a single symbol.
      properties:
        Symbol:
          type: string
          description: The symbol identifier.
        Last:
          type: number
          format: double
          description: The last traded price.
        Bid:
          type: number
          format: double
          description: The current bid price.
        Ask:
          type: number
          format: double
          description: The current ask price.
        BidSize:
          type: integer
          description: The size of the bid in shares or contracts.
        AskSize:
          type: integer
          description: The size of the ask in shares or contracts.
        Volume:
          type: integer
          description: The total volume traded today.
        Open:
          type: number
          format: double
          description: The opening price for the current session.
        High:
          type: number
          format: double
          description: The highest price for the current session.
        Low:
          type: number
          format: double
          description: The lowest price for the current session.
        Close:
          type: number
          format: double
          description: The previous session closing price.
        NetChange:
          type: number
          format: double
          description: Net change from previous close.
        NetChangePct:
          type: number
          format: double
          description: Net change as a percentage.
        TradeTime:
          type: string
          format: date-time
          description: The timestamp of the last trade.
    QuotesResponse:
      type: object
      description: Response containing quote data for one or more symbols.
      properties:
        Quotes:
          type: array
          description: List of quote snapshots.
          items:
            $ref: '#/components/schemas/Quote'
    CryptoPairsResponse:
      type: object
      description: Response containing available cryptocurrency trading pairs.
      properties:
        SymbolNames:
          type: array
          description: List of cryptocurrency pair symbol names.
          items:
            type: string
  parameters:
    Symbols:
      name: symbols
      in: path
      required: true
      description: One or more symbol identifiers, comma-separated.
      schema:
        type: string
  securitySchemes:
    oauth2AuthCode:
      type: oauth2
      description: OAuth 2.0 authorization code flow for accessing TradeStation API resources. Requires user authorization and supports token refresh.
      flows:
        authorizationCode:
          authorizationUrl: https://signin.tradestation.com/authorize
          tokenUrl: https://signin.tradestation.com/oauth/token
          scopes:
            marketdata: Access to market data endpoints
            readaccount: Read access to account information
            trade: Access to order placement and management
externalDocs:
  description: TradeStation API Documentation
  url: https://api.tradestation.com/docs/