iT邦幫忙

2021 iThome 鐵人賽

DAY 8
0
永豐金融APIs

永豐金融APIs - 從零開始到放棄!?系列 第 8

基本操作 - 歷史資訊

根據官方說明,因為歷史資料的查詢蠻耗資源的,有可能會拖慢系統的速度,所以官方不建議使用,而且有每5秒上限500次的限制,如果超過就到暫停服務,所以大家在使用的時候不要濫用。

個股 tick 資訊

取得個股的整日即時資料

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]

Snapshots

取得多檔個股的當日行情

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線

取得個股的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()即建立一個連線。


上一篇
基本操作 - 帳務
下一篇
繪圖 - 即時行情
系列文
永豐金融APIs - 從零開始到放棄!?30

尚未有邦友留言

立即登入留言