操作功能前請先登入
詳細功能請參考 API Reference/daccount
保證金查詢
使用 daccount.get_margin 方法查詢指定帳號的權益數與保證金資訊。 需傳入 帳號 與 幣別 (如 ‘NTT’)。
# 保證金查詢範例
actno = '帳號'
response = unitrade.daccount.get_margin(actno, 'NTT')
# print(response)
點擊查看 DMarginResponse 回傳範例
DMarginResponse(
ok=True,
error='',
data=DMargin(
total_count=1, # 總筆數
current_count=1, # 現在筆數
network_id='A00009z103',# 網路序號
company='F008000', # 公司別
actno='1234567', # 帳號
account_date='20250619',# 帳務日期
currency='NTT', # 幣別
exrate=1.0, # 匯率
lctdab=216432431.0, # 昨日權益數
ltdab=212177921.0, # 昨日餘額
dwamt=0.0, # 存提
osprtlos=0.0, # 期貨平倉損益
prtlos=4254510.0, # 未沖銷期貨浮動損益
optosprtlos=0.0, # 選擇權平倉損益
optprtlos=14741150.0, # 選擇權未平倉損益
tpremium=0.0, # 當日權利金支出收入
orignfee=0.0, # 成交手續費
ctaxamt=0.0, # 成交期交稅
ordpremium=0.0, # 委託預扣權利金
ctdab=216432431.0, # 權益數
ordiamt=0.0, # 委託預扣原始保證金
iamt=19357150.0, # 原始保證金
mamt=15208800.0, # 維持保證金
ordcexcess=197075281.0, # 可動用(出金) 保證金
bpremium=25055200.0, # 買方選擇權市值
spremium=1819050.0, # 賣方選擇權市值
optequity=239668581.0, # 權益總值
inirate=1118.1007, # 原始比率
matrate=1423.0737, # 維持比率
liquidation_ratio=1238.1398, # 清算比率
optrate=562.69, # 風險指標
update_date='20250619', # 資料更新日期
data_source_type='RT', # 資料來源類別
# ... (其餘欄位請參考 API 文件)
)
)
未平倉查詢
使用 daccount.get_unliquidation 方法查詢指定帳號的未平倉部位。
# 未平倉查詢範例
response = unitrade.daccount.get_unliquidation(actno, 'NTT')
# print(response)
點擊查看 DUnliquidationResponse 回傳範例
DUnliquidationResponse(
ok=True,
error='',
data=[
DUnliquidation(
total_count=32, # 總筆數
current_count=1, # 現在筆數
productid='NY1G5', # 商品代碼
bs='S', # 買賣別
totalotqty=39, # 留倉口數
avgmatchprice=48.4426, # 成交均價
realprice=43.82, # 即時價
reftotalpl=6619200.0, # 浮動損益
net_profit_loss=6617012.0, # 淨損益
product_name='元大台50 107', # 商品名稱
leg1_productid='NY1', # 腳一商品
leg1_buy_sell='S', # 腳一買賣別
# ... (其餘欄位請參考 API 文件)
),
# ... 更多未平倉部位
]
)
即時部位查詢
使用 daccount.get_position 方法查詢指定帳號的即時部位（包含今日委託與成交資訊）。
# 即時部位查詢範例
response = unitrade.daccount.get_position(actno, 'NTT')
# print(response)
點擊查看 DPositionResponse 回傳範例
DPositionResponse(
ok=True,
error='',
data=[
DPosition(
product='NY1', # 商品
month='202507', # 月份
call_put='', # Call/Put
strike_price=0.0, # 履約價
ot_qty_b=0, # 前日買進留倉
ot_qty_s=39, # 前日賣出留倉
noworder_qty_b=0, # 本日買進委託
noworder_qty_s=0, # 本日賣出委託
nowmatch_qty_b=0, # 本日買進成交
nowmatch_qty_s=0, # 本日賣出成交
today_close_position=0, # 本日平倉
current_buy_open_position=0, # 目前買進留倉
current_sell_open_position=39,# 目前賣出留倉
buyer_IAMT=0.0, # 買方原始保證金
seller_IAMT=6123000.0, # 賣方原始保證金
floating_pnl=7211100.0, # 浮動損益
productid='NY1G5', # 商品代碼
# ... (其餘欄位請參考 API 文件)
),
# ... 更多部位資料
]
)
申請組拆功能
V1.0.0.4 新增
使用 daccount.get_combine 方法進行部位的組合或拆解。
參數順序說明：
- 申請種類 (
str): “1”=期貨鎖單, “2”=期貨解鎖, “3”=選擇權組合, “4”=選擇權拆解 - 帳號 (
str) - 第一隻腳商品代碼 (
str): 如 “TXO” - 第一隻腳年月 (
str): 如 “202507” - 第一隻腳履約價 (
str): 期貨填 “0” - 第一隻腳買賣權 (
str): 期貨填 “ “, 選擇權填 “C” 或 “P” - 第一隻腳買賣別 (
str): “B” 或 “S” - 第一隻腳口數 (
int) - 第二隻腳商品代碼 (
str) - 第二隻腳年月 (
str) - 第二隻腳履約價 (
str) - 第二隻腳買賣權 (
str) - 第二隻腳買賣別 (
str) - 第二隻腳口數 (
int)
# 申請組合範例 (買權多頭價差)
response = unitrade.daccount.get_combine(
"3", # 3: 選擇權組合
actno, # 帳號
"TXO", "202507", "21000", "C", "S", 1, # 第一隻腳: Sell Call 21000
"TXO", "202507", "21200", "C", "B", 1 # 第二隻腳: Buy Call 21200
)
# 回傳範例
# 成功: Response(ok=True, error='')
# 失敗: Response(ok=False, error='無此組合商品')
print(f"申請結果: {response.ok}, 訊息: {response.error}")
申請買賣並存沖銷
V1.0.0.4 新增
使用 daccount.get_net 方法申請指定帳號的買賣並存部位進行沖銷（Net）。
# 申請指定沖銷範例
response = unitrade.daccount.get_net(actno)
# 回傳範例
# 成功: Response(ok=True, error='')
# 失敗: Response(ok=False, error='全組或全拆筆數為零')
print(f"申請結果: {response.ok}, 訊息: {response.error}")