instruments - 合约详细信息

  • rqalpha.api.instruments(*args, **kwargs)[源代码]
  • 获取某个国家市场内一个或多个合约的详细信息。目前仅支持中国市场。

参数:id_or_symbols (str | List[str]) – 合约代码或者合约代码列表返回:StockInstrument | FutureInstrument

目前系统并不支持跨国家市场的同时调用。传入 order_book_id list必须属于同一国家市场，不能混合着中美两个国家市场的order_book_id。

Example:

  • 获取单一股票合约的详细信息:
  1. [In]instruments('000001.XSHE')
  2. [Out]
  3. Instrument(order_book_id=000001.XSHE, symbol=平安银行, abbrev_symbol=PAYH, listed_date=19910403, de_listed_date=null, board_type=MainBoard, sector_code_name=金融, sector_code=Financials, round_lot=100, exchange=XSHE, special_type=Normal, status=Active)
  • 获取多个股票合约的详细信息:
  1. [In]instruments(['000001.XSHE', '000024.XSHE'])
  2. [Out]
  3. [Instrument(order_book_id=000001.XSHE, symbol=平安银行, abbrev_symbol=PAYH, listed_date=19910403, de_listed_date=null, board_type=MainBoard, sector_code_name=金融, sector_code=Financials, round_lot=100, exchange=XSHE, special_type=Normal, status=Active), Instrument(order_book_id=000024.XSHE, symbol=招商地产, abbrev_symbol=ZSDC, listed_date=19930607, de_listed_date=null, board_type=MainBoard, sector_code_name=金融, sector_code=Financials, round_lot=100, exchange=XSHE, special_type=Normal, status=Active)]
  • 获取合约已上市天数:
  1. instruments('000001.XSHE').days_from_listed()
  • 获取合约距离到期天数:
  1. instruments('IF1701').days_to_expire()