Intraday Trades
取得股票成交明細(依代碼查詢)
GET /intraday/trades/{symbol}
Parameters
| Name | Type | Description |
|---|---|---|
symbol* | string | 股票代碼 |
type | string | Ticker 類型,可選 oddlot 盤中零股 |
offset | number | 偏移量 |
limit | number | 限制量,預設 50,上限 500(超過上限時回傳 500 筆,不會回錯誤) |
sort | string | 時間排序,預設為 desc 降冪,可選 asc 升冪 |
isTrial | boolean | 查詢試撮明細: true |
分頁
要取完當日成交,從 offset=0 開始,每次以 limit=500 遞增 offset,直到 data 為空陣列為止;offset 超過總筆數時回傳 HTTP 200 與空的 data,不是錯誤。
建議在收盤後再分頁取完。交易時段進行中以預設的 desc 分頁時,新成交會排到最前面、後面的頁面隨之往後位移,相鄰兩頁之間會出現重複的成交。
盤後交易的成交
當日有盤後定價交易時,收盤後的成交明細會多一筆 time 為 14:30、serial 為 99999999 的成交,size 為盤後定價交易的成交量;查詢盤中零股(type=oddlot)時,這筆為盤後零股交易的成交量。這筆成交不計入 volume 與 Intraday Quote 的累計成交量,本身也沒有 volume 欄位(整股另沒有 bid、ask),分頁加總成交量時請排除。
Response
| Name | Type | Description |
|---|---|---|
date* | string | 日期 |
type* | string | Ticker 類型 |
exchange* | string | 交易所 |
market | string | 市場別 |
symbol* | string | 股票代碼 |
data* | object[] | 成交明細 |
data[0].bid | number | 成交買價 |
data[0].ask | number | 成交賣價 |
data[0].price | number | 成交價格 |
data[0].size | number | 成交單量 |
data[0].volume | number | 成交總量 |
data[0].time | number | 成交時間 |
data[0].serial | number | 流水號 |
Example
- cURL
- Python
- Node.js
curl -X 'GET' \
'https://api.fugle.tw/marketdata/v1.0/stock/intraday/trades/0050' \
-H 'X-API-KEY: <YOUR_API_KEY>'
from fugle_marketdata import RestClient
client = RestClient(api_key='YOUR_API_KEY')
stock = client.stock
print(stock.intraday.trades(symbol='2330'))
const { RestClient } = require('@fugle/marketdata');
const client = new RestClient({ apiKey: 'YOUR_API_KEY' });
client.stock.intraday.trades({ symbol: '2330' })
.then(data => console.log(data));
Response Body:
{
"date": "2023-05-29",
"type": "EQUITY",
"exchange": "TWSE",
"market": "TSE",
"symbol": "2330",
"data": [
{
"price": 568,
"size": 32,
"time": 1685341800000000,
"serial": 99999999
},
{
"bid": 567,
"ask": 568,
"price": 568,
"size": 4778,
"volume": 54538,
"time": 1685338200000000,
"serial": 6652422
},
{
"bid": 565,
"ask": 566,
"price": 566,
"size": 1,
"volume": 49760,
"time": 1685337899721587,
"serial": 6622549
},
......
]
}