get_timesales_fields(symbol)

Description: 

Returns all valid fields available for a given symbol that can be used with the get_timesales() function. This helps ensure that users only request fields supported for that specific instrument (e.g., trades, quotes, conditions). 

Function Signature: 

get_timesales_fields(symbol: str) -> tuple

Parameters: 

Name Type Required Default Description
symbol str Yes A single instrument symbol (e.g., 'BRN 1!-ICE') for which available Time & Sales fields will be returned.

Return:

Returns a tuple of (field, label) pairs, where each pair is a valid field that can be passed to get_timesales() for the specified symbol.

Notes:

  • Field availability varies based on the symbol type (e.g., futures, equities, options).
  • Use this function before building a get_timesales() query to validate the fields dynamically.
  • Returned field names match those expected in the fields argument of get_timesales().