Options
get_option_expirations Get Option Expiration Dates
QuoteClient.get_option_expirations(symbols, market=None)
Description
Get option expiration dates
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbols | list[str] | Yes | List of underlying asset symbols. For Hong Kong contracts, use symbols provided by get_option_symbols in format "CODE.HK" |
| market | tigeropen.common.consts.Market | Yes | Market, US/HK for Hong Kong stocks. |
Returns
pandas.DataFrame
The meaning of each column is as follows:
| Parameter | Type | Description |
|---|---|---|
| symbol | str | Security code |
| date | str | Expiration date in YYYY-MM-DD format |
| timestamp | int | Expiration date timestamp in milliseconds |
| period_tag | str | Option period tag, m for monthly options, w for weekly options |
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.consts import Market
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
quote_client = QuoteClient(client_config)
expiration = quote_client.get_option_expirations(symbols=['AAPL'], market=Market.US)
#for HK contracts
#expirationHK = quote_client.get_option_expirations(symbols=["MET.HK"],market=Market.HK)
print(expiration.head())Return Example
symbol date timestamp
0 AAPL 2019-01-11 1547182800000
1 AAPL 2019-01-18 1547787600000
2 AAPL 2019-01-25 1548392400000
3 AAPL 2019-02-01 1548997200000
4 AAPL 2019-02-08 1549602000000
get_option_briefs Get Option Real-time Quotes
QuoteClient.get_option_briefs(identifiers, market=None, timezone=None)
Description
Get option real-time quotes
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| identifiers | list[str] | Yes | List of underlying asset symbols. For Hong Kong contracts, use symbols provided by get_option_symbols in format "CODE.HK" |
| market | tigeropen.common.consts.Market | Yes | Market, US: US stocks, HK: Hong Kong stocks. |
| timezone | str | No | Timezone, such as 'US/Eastern', 'Asia/Hong_Kong' |
Returns
pandas.DataFrame
The meaning of each column is as follows:
| Field | Type | Description |
|---|---|---|
| identifier | str | Option code |
| symbol | str | Stock code |
| strike | str | Strike price |
| bid_price | float | Bid price |
| bid_size | int | Bid size |
| ask_price | float | Ask price |
| ask_size | int | Ask size |
| latest_price | float | Latest price |
| latest_time | int | Latest trade time |
| volume | int | Volume |
| high | float | High price |
| low | float | Low price |
| open | float | Open price |
| pre_close | float | Previous close price |
| open_interest | int | Open interest |
| open | float | Open price |
| change | float | Price change |
| multiplier | int | Multiplier, default 100 for US options |
| rates_bonds | float | One-year US Treasury rate, updated daily, e.g., 0.0078 means actual rate: 0.78% |
| put_call | str | Direction (PUT/CALL) |
| volatility | str | Historical volatility |
| expiry | int | Expiration time (milliseconds, midnight of the day) |
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.consts import Market
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
quote_client = QuoteClient(client_config)
briefs = quote_client.get_option_briefs(['AAPL 230317C000135000'], market=Market.US)
# Hong Kong options
# briefs = quote_client.get_option_briefs(['TCH.HK 230317C000135000'], market=Market.HK)Return Example
identifier symbol expiry strike put_call multiplier ask_price open \
NVDA 260116C00100000 NVDA 1768539600000 100.0 CALL 100 79.05 65 \
ask_size bid_price bid_size pre_close latest_price latest_time volume open_interest \
78.0 178 78.7 78.2 None 36 84175 78.09 \
high low rates_bonds volatility change
79.57 77.89 0.036165 29.29% -0.5
get_option_chain Get Option Chain
QuoteClient.get_option_chain(symbol, expiry, option_filter=None, return_greek_value=None, market=None, timezone=None, **kwargs)
Description
Get option chain
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | str | Yes | Stock code corresponding to the option |
| expiry | str or int | Yes | Option expiration date, numeric timestamp in milliseconds or date string, e.g., 1705640400000 or '2024-01-19' |
| option_filter | tigeropen.quote.domain.filter.OptionFilter | No | Filter parameters, optional |
| return_greek_value | bool | No | Whether to return Greek values |
| market | tigeropen.common.consts.Market | Yes | Market, supports US/HK |
| timezone | str | No | Timezone, such as 'US/Eastern', 'Asia/Hong_Kong' |
Filter parameters:
For all filtering indicators except the in_the_money attribute, other indicators use field names with _min suffix (representing minimum range value) or _max suffix (representing maximum range value), such as delta_min, theta_max. See code examples.
OptionFilter filterable indicators are as follows:
| Parameter | Type | Required | Description |
|---|---|---|---|
| implied_volatility | float | No | Implied volatility, reflecting the market's expectation of future stock price volatility. Higher implied volatility indicates expected greater price volatility. |
| in_the_money | bool | No | Whether in-the-money |
| open_interest | int | No | Open interest, the number of contracts held by market participants at the end of each trading day. Reflects market depth and liquidity. |
| delta | float | No | Delta, reflecting the impact of stock price changes on option price changes. For every $1 change in stock price, option price changes approximately by delta. Range: -1.0 ~ 1.0 |
| gamma | float | No | Gamma, reflecting the impact of stock price changes on delta. For every $1 change in stock price, delta changes by gamma. |
| theta | float | No | Theta, reflecting the impact of time changes on option price changes. For every day decrease in time, option price changes approximately by theta. |
| vega | float | No | Vega, reflecting the impact of volatility on option price changes. For every 1% change in volatility, option price changes approximately by vega. |
| rho | float | No | Rho, reflecting the impact of risk-free interest rate on option price changes. For every 1% change in risk-free rate, option price changes approximately by rho. |
Returns
pandas.DataFrame
| Field Name | Type | Description |
|---|---|---|
| identifier | str | Option code |
| symbol | str | Underlying stock code for the option |
| expiry | int | Option expiration date, millisecond timestamp |
| strike | float | Strike price |
| put_call | str | Option direction |
| multiplier | float | Multiplier |
| ask_price | float | Ask price |
| ask_size | int | Ask size |
| bid_price | float | Bid price |
| bid_size | int | Bid size |
| pre_close | float | Previous close |
| latest_price | float | Latest price |
| volume | int | Volume |
| open_interest | int | Open interest quantity |
| implied_vol | float | Implied volatility |
| delta | float | Delta |
| gamma | float | Gamma |
| theta | float | Theta |
| vega | float | Vega |
| rho | float | Rho |
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.consts import Market
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
quote_client = QuoteClient(client_config)
option_chain = quote_client.get_option_chain(symbol='AAPL', expiry='2019-01-18', market=Market.US)
# Hong Kong options
# option_chains = quote_client.get_option_chain(symbol='TCH.HK', expiry='2024-06-27', market='HK', return_greek_value=True)
print(option_chain)
# Can define OptionFilter for filtering
option_filter = OptionFilter(implied_volatility_min=0.5, implied_volatility_max=0.9, delta_min=0, delta_max=1,
open_interest_min=100, gamma_min=0.005, theta_max=-0.05, in_the_money=True)
option_chain = quote_client.get_option_chain('AAPL', '2023-01-20', option_filter=option_filter, market=Market.US)
print(option_chain)
# Can also filter directly using indicator names
option_chain = quote_client.get_option_chain('AAPL', '2023-01-20', implied_volatility_min=0.5, open_interest_min=200, vega_min=0.1, rho_max=0.9, market=Market.US)
# Convert expiry time format
option_chain['expiry_date'] = pd.to_datetime(option_chain['expiry'], unit='ms').dt.tz_localize('UTC').dt.tz_convert('US/Eastern')Return Example
symbol expiry identifier strike put_call volume latest_price \
0 AAPL 1689912000000 AAPL 230721C00095000 95.0 CALL 0 80.47
1 AAPL 1689912000000 AAPL 230721C00100000 100.0 CALL 0 73.50
pre_close open_interest multiplier implied_vol delta gamma theta vega \
80.47 117 100 0.989442 0.957255 0.001332 -0.061754 0.059986 \
76.85 206 100 0.903816 0.955884 0.001497 -0.058678 0.060930 \
rho expiry_date
0.133840 2023-07-21 00:00:00-04:00
0.141341 2023-07-21 00:00:00-04:00
get_option_depth Get Option Depth Market Data
QuoteClient.get_option_depth(identifiers: list[str], market, timezone=None)
Description
Get option depth market data. Supports US and Hong Kong market options.
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| identifiers | list[str] | Yes | List of option codes, e.g., ['AAPL 220128C000175000']. Format Description |
| market | tigeropen.common.consts.Market | Yes | Market, US/HK |
| timezone | str | No | Timezone, default value is 'US/Eastern', Hong Kong options need to pass 'Asia/Hong_Kong' |
Returns
dict
Structure as follows:
| Parameter | Type | Description |
|---|---|---|
| identifier | str | Option symbol |
| asks | list[tuple] | Ask information |
| bids | list[tuple] | Bid information |
Each item in asks and bids is a tuple, with tuple elements composed of (price, volume, timestamp, code)
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.consts import Market
from tigeropen.common.util.contract_utils import get_option_identifier
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
# or client_config = get_client_config(props_path='path to tiger_openapi_config.properties file')
quote_client = QuoteClient(client_config)
identifier = 'AAPL 190104P00134000'
# Or generated from four elements
# identifier = get_option_identifier('AAPL', '20190104', 'PUT', 134)
result = quote_client.get_option_depth([identifier], market=Market.US)
print(result)Return Example
Single underlying:
{'identifier': 'ADBE 240816C00560000',
'asks': [(18.3, 36, 1719852973090, 'PHLX'), (18.3, 19, 1719852973090, 'EDGX'), (18.3, 14, 1719852972660, 'MPRL'), (18.3, 14, 1719852972512, 'BOX'), (18.3, 13, 1719852973090, 'EMLD'), (18.3, 12, 1719852973090, 'MIAX'), (18.3, 11, 1719852969837, 'ISE'), (18.3, 10, 1719852973487, 'AMEX'), (18.3, 10, 1719852973090, 'CBOE'), (18.3, 7, 1719852973090, 'GEM'), (18.3, 7, 1719852969591, 'MCRY'), (18.3, 7, 1719852969585, 'BZX'), (18.3, 6, 1719852969647, 'NSDQ'), (18.3, 4, 1719852973525, 'ARCA'), (18.3, 3, 1719852972512, 'MEMX'), (18.3, 3, 1719852969818, 'C2'), (18.3, 2, 1719852973422, 'BX')],
'bids': [(17.9, 8, 1719852972512, 'BOX'), (17.9, 7, 1719852973487, 'AMEX'), (17.9, 6, 1719852973090, 'EMLD'), (17.9, 6, 1719852972660, 'MPRL'), (17.9, 6, 1719852969837, 'ISE'), (17.9, 5, 1719852973422, 'BX'), (17.9, 5, 1719852973090, 'PHLX'), (17.9, 5, 1719852969647, 'NSDQ'), (17.9, 5, 1719852969591, 'MCRY'), (17.9, 4, 1719852973090, 'EDGX'), (17.9, 4, 1719852973090, 'MIAX'), (17.9, 3, 1719852973525, 'ARCA'), (17.9, 2, 1719852973090, 'CBOE'), (17.9, 2, 1719852973090, 'GEM'), (17.9, 2, 1719852969818, 'C2'), (17.9, 1, 1719852969585, 'BZX'), (17.85, 6, 1719852972512, 'MEMX')]
}
Multiple underlyings:
{'ADBE 240816C00560000':
{'identifier': 'ADBE 240816C00560000',
'asks': [(18.3, 36, 1719852973090, 'PHLX'), (18.3, 19, 1719852973090, 'EDGX'), (18.3, 14, 1719852972660, 'MPRL'), (18.3, 14, 1719852972512, 'BOX'), (18.3, 13, 1719852973090, 'EMLD'), (18.3, 12, 1719852973090, 'MIAX'), (18.3, 11, 1719852969837, 'ISE'), (18.3, 10, 1719852973487, 'AMEX'), (18.3, 10, 1719852973090, 'CBOE'), (18.3, 7, 1719852973090, 'GEM'), (18.3, 7, 1719852969591, 'MCRY'), (18.3, 7, 1719852969585, 'BZX'), (18.3, 6, 1719852969647, 'NSDQ'), (18.3, 4, 1719852973525, 'ARCA'), (18.3, 3, 1719852972512, 'MEMX'), (18.3, 3, 1719852969818, 'C2'), (18.3, 2, 1719852973422, 'BX')],
'bids': [(17.9, 8, 1719852972512, 'BOX'), (17.9, 7, 1719852973487, 'AMEX'), (17.9, 6, 1719852973090, 'EMLD'), (17.9, 6, 1719852972660, 'MPRL'), (17.9, 6, 1719852969837, 'ISE'), (17.9, 5, 1719852973422, 'BX'), (17.9, 5, 1719852973090, 'PHLX'), (17.9, 5, 1719852969647, 'NSDQ'), (17.9, 5, 1719852969591, 'MCRY'), (17.9, 4, 1719852973090, 'EDGX'), (17.9, 4, 1719852973090, 'MIAX'), (17.9, 3, 1719852973525, 'ARCA'), (17.9, 2, 1719852973090, 'CBOE'), (17.9, 2, 1719852973090, 'GEM'), (17.9, 2, 1719852969818, 'C2'), (17.9, 1, 1719852969585, 'BZX'), (17.85, 6, 1719852972512, 'MEMX')]},
'ADBE 240816P00560000':
{'identifier': 'ADBE 240816P00560000',
'asks': [(17.45, 6, 1719863999000, 'BOX'), (17.45, 5, 1719863999000, 'EMLD'), (17.45, 5, 1719863999000, 'PHLX'), (17.45, 1, 1719863999000, 'CBOE'), (17.45, 1, 1719863999000, 'ISE'), (17.45, 1, 1719863999000, 'ARCA'), (17.45, 1, 1719863999000, 'MPRL'), (17.45, 1, 1719863999000, 'NSDQ'), (17.45, 1, 1719863999000, 'BX'), (17.45, 1, 1719863999000, 'C2'), (17.45, 1, 1719863999000, 'BZX'), (21.65, 4, 1719863999000, 'EDGX'), (22.0, 2, 1719863999000, 'AMEX'), (27.3, 1, 1719863999000, 'GEM'), (27.5, 1, 1719863999000, 'MIAX'), (28.0, 1, 1719863999000, 'MCRY'), (0.0, 0, 1719864000000, 'MEMX')],
'bids': [(17.05, 6, 1719863999000, 'ISE'), (17.05, 5, 1719863999000, 'BOX'), (17.05, 5, 1719863999000, 'PHLX'), (17.05, 3, 1719863999000, 'MCRY'), (17.05, 2, 1719863999000, 'ARCA'), (17.05, 2, 1719863999000, 'MPRL'), (17.05, 2, 1719863999000, 'NSDQ'), (17.05, 2, 1719863999000, 'BX'), (17.05, 2, 1719863999000, 'BZX'), (17.05, 1, 1719863999000, 'AMEX'), (17.05, 1, 1719863999000, 'CBOE'), (17.05, 1, 1719863999000, 'GEM'), (17.05, 1, 1719863999000, 'C2'), (15.6, 1, 1719863999000, 'EDGX'), (15.5, 1, 1719863999000, 'MIAX'), (11.95, 1, 1719863999000, 'EMLD'), (0.0, 0, 1719864000000, 'MEMX')]}
}
get_option_trade_ticks Get Option Tick-by-Tick Trade Data
QuoteClient.get_option_trade_ticks(identifiers)
Description
Get option tick-by-tick trade data
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| identifiers | list[str] | Yes | List of option codes, e.g., ['AAPL 220128C000175000']. Format Description |
Returns
pandas.DataFrame
Structure as follows:
| Parameter | Type | Description |
|---|---|---|
| symbol | str | Underlying stock code for the option |
| expiry | str | Option expiration time in YYYY-MM-DD format |
| put_call | str | Option direction |
| strike | float | Strike price |
| time | int | Trade time |
| price | float | Trade price |
| volume | int | Trade volume |
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.util.contract_utils import get_option_identifier
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
quote_client = QuoteClient(client_config)
identifier = 'AAPL 190104P00134000'
# Or generated from four elements
# identifier = get_option_identifier('AAPL', '20190104', 'PUT', 134)
option_trade_ticks = quote_client.get_option_trade_ticks([identifier])Return Example
identifier symbol expiry put_call strike time price volume
0 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640701803177 9.38 9
1 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640701803177 9.38 1
2 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640701803846 9.46 7
3 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640701806266 9.55 1
4 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640701918302 9.08 1
.. ... ... ... ... ... ... ... ...
111 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640722112754 8.91 25
112 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640723067491 9.00 4
113 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640723585351 8.85 4
114 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640724302670 9.13 2
115 AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1640724600973 8.85 1
get_option_bars Get Option Daily K-line Data
QuoteClient.get_option_bars(identifiers, begin_time=-1, end_time=4070880000000, period=BarPeriod.DAY, limit=None, sort_dir=None, market=None, timezone=None)
Description
Get option K-line data
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter Name | Type | Required | Description |
|---|---|---|---|
| identifiers | list[str] | Yes | Option code list, maximum 30 per request, e.g. ['AAPL 220128C000175000'], Format Description |
| begin_time | str or int | Yes | Start time, millisecond timestamp or date string, e.g. 1643346000000 or '2019-01-01' |
| end_time | str or int | Yes | End time, millisecond timestamp or date string, e.g. 1643346000000 or '2019-01-01' |
| period | tigeropen.common.consts.BarPeriod | No | K-line type, value range (DAY: daily K, ONE_MINUTE: 1 minute, FIVE_MINUTES: 5 minutes, HALF_HOUR: 30 minutes, ONE_HOUR: 60 minutes) |
| limit | int | No | Number of K-lines returned per option |
| sort_dir | tigeropen.common.consts.SortDirection | No | Sort order, enum ASC/DESC, default ASC |
| market | tigeropen.common.consts.Market | Yes | Market, US: US stocks, HK: Hong Kong stocks |
| timezone | str | No | Time zone, e.g. 'US/Eastern', 'Asia/Hong_Kong' |
Returns
pandas.DataFrame
Structure as follows:
| Parameter Name | Type | Description |
|---|---|---|
| identifier | str | Option code |
| symbol | str | Underlying stock symbol |
| expiry | int | Expiry date, millisecond timestamp |
| put_call | str | Option direction |
| strike | float | Strike price |
| time | int | Bar time, millisecond timestamp |
| open | float | Opening price |
| high | float | Highest price |
| low | float | Lowest price |
| close | float | Closing price |
| volume | int | Trading volume |
| open_interest | int | Open interest |
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.consts import BarPeriod, Market
from tigeropen.common.util.contract_utils import get_option_identifier
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
quote_client = QuoteClient(client_config)
identifier = 'AAPL 190104P00134000'
# Or generated from four elements
# identifier = get_option_identifier('AAPL', '20190104', 'PUT', 134)
bars = quote_client.get_option_bars([identifier],period = BarPeriod.DAY, market=Market.US)
print(bars)
# Convert time format
bars['expiry_date'] = pd.to_datetime(bars['expiry'], unit='ms').dt.tz_localize('UTC').dt.tz_convert('US/Eastern')
bars['time_date'] = pd.to_datetime(bars['time'], unit='ms').dt.tz_localize('UTC').dt.tz_convert('US/Eastern')Return Example
identifier symbol expiry put_call strike time open high \
AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1639026000000 8.92 9.80 \ AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1639112400000 9.05 10.80 \ AAPL 220128C00175000 AAPL 1643346000000 CALL 175.0 1639371600000 11.70 12.50 \
low close volume open_interest expiry_date time_date
8.00 8.20 364 0 2022-01-28 00:00:00-05:00 2021-12-09 00:00:00-05:00
7.80 10.80 277 177 2022-01-28 00:00:00-05:00 2021-12-10 00:00:00-05:00
8.72 8.75 304 328 2022-01-28 00:00:00-05:00 2021-12-13 00:00:00-05:00
get_option_timeline Get Option Time-Series Data
QuoteClient.get_option_timeline(self, identifiers: Union[str, list[str]], market:Optional[Union[Market, str]] = None, begin_time: Optional[Union[str, int]] = None, timezone: Optional[str] = None)
Description
Get time-series data for options
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| identifiers | list[str] | Yes | Option code list, maximum 30 per request, e.g. ['AAPL 220128C000175000'], Format Description |
| market | Market | Yes | Market, default HK, currently only supports HK |
Returns
| Field | Type | Description |
|---|---|---|
| identifier | str | Option symbol |
| symbol | str | Stock code |
| put_call | str | Call or Put (CALL/PUT) |
| expiry | int | Expiry time |
| strike | str | Strike price |
| pre_close | float | Previous day's closing price |
| volume | int | Trading volume |
| avg_price | double | Average trading price |
| price | double | Latest price |
| time | int | Current time-series time |
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.consts import BarPeriod, Market
from tigeropen.common.util.contract_utils import get_option_identifier
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
quote_client = QuoteClient(client_config)
identifier = 'TCH.HK 250929C00510000'
# Or generated from four elements
# identifier = get_option_identifier('TCH.HK', '20190104', 'PUT', 134)
result = quote_client.get_option_timeline([identifier], market=Market.HK)
print(result)
Return Example
identifier symbol expiry put_call strike pre_close price \
0 TCH.HK250929C00510000 TCH.HK 1759075200000 CALL 510.00 29.36 29.36 \
1 TCH.HK250929C00510000 TCH.HK 1759075200000 CALL 510.00 29.36 29.36 \
2 TCH.HK250929C00510000 TCH.HK 1759075200000 CALL 510.00 29.36 29.36 \
avg_price time volume
29.360000 1750901400000 0
29.360000 1750901460000 0
29.360000 1750901520000 0
get_option_symbols Get Hong Kong Stock Option Codes
QuoteClient.get_option_symbols(market = Market.HK, lang = Language.en_US)
Description
Get Hong Kong stock option codes, for example, the code for 00700 is TCH.HK
Request Frequency
For frequency limits, please refer to: API Request Limits
Parameters
| Parameter Name | Type | Required | Description |
|---|---|---|---|
| market | tigeropen.common.consts.Market | No | Market.HK |
| lang | Language | No | Language for returned information, optional, defaults to English |
Returns
pandas.DataFrame
Structure as follows:
| Parameter Name | Type | Description |
|---|---|---|
| symbol | str | Option code, e.g. TCH.HK |
| name | str | Name |
| underlying_symbol | str | Hong Kong stock code, e.g. 00700 |
Example
from tigeropen.quote.quote_client import QuoteClient
from tigeropen.common.util.contract_utils import get_option_identifier
from tigeropen.tiger_open_config import TigerOpenClientConfig
client_config = TigerOpenClientConfig(props_path='/path/to/your/properties/file/')
quote_client = QuoteClient(client_config)
result = quote_client.get_option_symbols()
print(result)Return Example
symbol name underlying_symbol
0 ALC.HK ALC 02600
1 CRG.HK CRG 00390
2 PAI.HK PAI 02318
3 XCC.HK XCC 00939
4 XTW.HK XTW 00788
5 SHL.HK SHL 00968
6 GHL.HK GHL 00868
7 HEX.HK HEX 00388
8 ACC.HK ACC 00914
9 STC.HK STC 02888Updated 9 days ago
