根據官方說明,因為歷史資料的查詢蠻耗資源的,有可能會拖慢系統的速度,所以官方不建議使用,而且有每5秒上限500次的限制,如果超過就到暫停服務,所以大家在使用的時候不要濫用。
取得個股的整日即時資料
stock2303 = api.Contracts.Stocks["2303"]
api.ticks(stock2330)
參數:
api.ticks(
contract: shioaji.contracts.BaseContract,
date: str = '2021-09-22', 預設當日
query_type: shioaji.constant.TicksQueryType = <TicksQueryType.AllDay: 'AllDay'>, 預設整日
time_start: Union[str, datetime.time] = None, 開始時間
time_end: Union[str, datetime.time] = None, 結束時間
last_cnt: int = 0,
timeout: int = 30000,
cb: Callable[[shioaji.data.Ticks], NoneType] = None,
) -> shioaji.data.Ticks
回傳格式:
ts: typing.List[int]
close: typing.List[float]
volume: typing.List[int]
bid_price: typing.List[float]
bid_volume: typing.List[int]
ask_price: typing.List[float]
ask_volume: typing.List[int]
取得多檔個股的當日行情
stock2303 = api.Contracts.Stocks["2303"]
stock2330 = api.Contracts.Stocks["2330"]
api.snapshots([stock2303, stock2330])
參數:
api.snapshots(
contracts: List[Union[shioaji.contracts.Option, shioaji.contracts.Future, shioaji.contracts.Stock, shioaji.contracts.Index]], contracts 集合(股票,期貨,選擇權)
timeout: int = 30000,
cb: Callable[[shioaji.data.Snapshot], NoneType] = None,
) -> List[shioaji.data.Snapshot]
回傳格式:
ts: int
code: str
exchange: str
open: float
high: float
low: float
close: float
tick_type: TickType
change_price: float
change_rate: float
change_type: ChangeType
average_price: float
volume: int
total_volume: int
amount: int
total_amount: int
yesterday_volume: float
buy_price: float
buy_volume: float
sell_price: float
sell_volume: int
取得個股的k線資料
api.kbars()
參數:
api.kbars(
contract: shioaji.contracts.BaseContract,
start: str = '2021-09-22', 開始日期
end: str = '2021-09-23', 結束日期
timeout: int = 30000,
cb: Callable[[shioaji.data.Kbars], NoneType] = None,
) -> shioaji.data.Kbars
回傳格式:
ts: typing.List[int]
Open: typing.List[float]
High: typing.List[float]
Low: typing.List[float]
Close: typing.List[float]
Volume: typing.List[int]
Amount: typing.List[float]
行情(data) : 相關查詢,5秒上限500次
包含 credit_enquire、short_stock_sources、snapshots、ticks、kbars。帳務(portfolio) : 相關查詢,5秒上限25次
包含 list_profit_loss_detail、account_balance、list_settlements、list_profit_loss、list_positions。委託(order) : 相關查詢,10秒上限500次
包含 place_order、update_status、update_qty、update_price、cancel_order。連線限制: 同一永豐金證券person_id,僅可使用最多5個連線
api.login()即建立一個連線。