交易所報明牌注意股票(事件導向型)台灣上市上櫃

ZXA-14003b

交易所公告注意股票

說明

API 介接說明

壹、主要規格說明

(一)Token驗證機制

介接端須先透過取得的應用程式編號與應用程式密鑰取得一次性的有效交易驗證碼,於每次API呼叫時帶入 HTTP HEADER 提供驗證才能使用相關API。此驗證碼於特定時間後會 timeout過期,此時必須重新取得交易驗證碼得以再次操作相關API。

(二)情境流程示意
(三)HTTP 回應狀態碼說明
HTTP Status Code 說明
200 OK 接受請求並回覆結果
400 BAD REQUEST 請求的網址參數不合法,請確認請求資料的正確性
401 UNAUTHORIZED 尚未認證或驗證碼已過期不合法,請重新認證
403 FORBIDDEN 無權存取指定請求,請確認有相關使用權限
404 NOT FOUND 指定的請求不存在,請確認請求網址的正確性
500 INTERNAL SERVER ERROR 內部系統錯誤,請稍候再試

貳、API參考說明

一、 取得交易驗證碼
服務網址 {服務網站}/OwlApi/auth
服務網址 HTTP METHOD POST
Content-Type application/x-www-form-urlencoded
參數 中文說明 資料格式 備註
appId 應用程式編號 字串 必要
appSecret 應用程式密鑰 字串 必要
輸出說明 成功HTTP STATUS 200
Content-Type application/json;charset=UTF-8
回傳內容 JSON object
欄位 中文說明 資料格式 備註
token 交易驗證碼 字串
輸出範例 {"token":"eyJhbGciOiJIUzUxMiJ9.eyJqdGkiOiIyMDE3MTIyNTE0NDgyMDE3"}
curl請求範例 curl -i -X POST -d 'appId=20171225144820172&appSecret=9817af70e93f11e7be81bc5ff41a85ea' {服務網站}/OwlApi/auth
二、 個股資訊取得方式
服務網址 {服務網站}/OwlApi/api/v2/{格式}/{產品代碼}/{股票代號}/{期數}
輸入說明 HTTP METHOD GET
HTTP HEADER Authorization Bearer 取得的交易驗證碼
輸出說明 成功HTTP STATUS 200
Content-Type json -> application/json;charset=utf-8
csv -> text/csv;charset=utf-8
xml -> application/xml
xlsx -> application/vnd.ms-excel
回傳內容 視產品代碼與請求格式而定
輸出範例 視產品代碼與請求格式而定
curl請求範例 curl -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJqdGkiOiIyMDE3MTIyNTE0NDgyMDE3MiIsImV4cCI6MTUxNTAzMzc0MX0.xSQkbNRJlN8JIhkLxUXFCUuZCogHk15T8Ns7LSc1FsAbGZa3SuZbVmvbx46skX1o09yALThn_SiZj1z3S0uVbw" {服務網站}/OwlApi/api/v2/json/A4-10182a/2330/20
三、 多股資訊取得方式
服務網址 {服務網站}/OwlApi/api/v2/{格式}/{產品代碼}
輸入說明 HTTP METHOD GET
HTTP HEADER Authorization Bearer 取得的交易驗證碼
輸出說明 成功HTTP STATUS 200
Content-Type json -> application/json;charset=utf-8
csv -> text/csv;charset=utf-8
xml -> application/xml
xlsx -> application/vnd.ms-excel
回傳內容 視產品代碼與請求格式而定
輸出範例 視產品代碼與請求格式而定
curl請求範例 curl -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJqdGkiOiIyMDE3MTIyNTE0NDgyMDE3MiIsImV4cCI6MTUxNTAzMzc0MX0.xSQkbNRJlN8JIhkLxUXFCUuZCogHk15T8Ns7LSc1FsAbGZa3SuZbVmvbx46skX1o09yALThn_SiZj1z3S0uVbw" {服務網站}/OwlApi/api/v2/json/D1-10127b

範例僅供參考,實際內容依收到資料為主

股票代號 股票名稱 注意交易資訊 當年度累積次數 市值 財務信評 收盤價 漲跌 漲幅(%)
5469 瀚宇博 最近六個營業日累積收盤價漲幅達27.59%。且12月18日之成交量為最近六十個營業日日平均成交量之6.82倍﹝第三款﹞。 1 101.8 7 22.60 2.05 9.98
8067 志旭 最近六個營業日(含當日)累積之最後成交價漲幅達28%,當日之成交量較最近六十個營業日日平均成交量放大7.46倍(第三款) 2 3.1 9 10.45 0.93 9.77
8437 大地-KY 最近六個營業日(含當日)之日平均成交量較最近六十個營業日日平均成交量放大為5.32倍,當日成交量較最近六十個營業日之日平均成交量放大為8.15倍(第六款) 1 80.8 3 235.50 21.00 9.79
  • 股票代號 5469
    股票名稱 瀚宇博
    注意交易資訊 最近六個營業日累積收盤價漲幅達27.59%。且12月18日之成交量為最近六十個營業日日平均成交量之6.82倍﹝第三款﹞。
    當年度累積次數 1
    市值 101.8
    財務信評 7
    收盤價 22.60
    漲跌 2.05
    漲幅(%) 9.98
  • 股票代號 8067
    股票名稱 志旭
    注意交易資訊 最近六個營業日(含當日)累積之最後成交價漲幅達28%,當日之成交量較最近六十個營業日日平均成交量放大7.46倍(第三款)
    當年度累積次數 2
    市值 3.1
    財務信評 9
    收盤價 10.45
    漲跌 0.93
    漲幅(%) 9.77
  • 股票代號 8437
    股票名稱 大地-KY
    注意交易資訊 最近六個營業日(含當日)之日平均成交量較最近六十個營業日日平均成交量放大為5.32倍,當日成交量較最近六十個營業日之日平均成交量放大為8.15倍(第六款)
    當年度累積次數 1
    市值 80.8
    財務信評 3
    收盤價 235.50
    漲跌 21.00
    漲幅(%) 9.79