操作功能前請先登入

詳細功能請參考 API Reference/pfcf

下載範例

內期商品查詢

透過 get_domestic_products 方法可取得所有內期商品資訊（如商品代碼、合約規格等）。

# 內期商品取得範例 
domestic_products = unitrade.get_domestic_products()
# print(domestic_products)

點擊查看回傳資料結構範例

回傳值為一個 Dictionary，Key 為商品代碼。

{
    'TXF': DomesticProduct(
        kinid='TXF',
        name='臺指',
        stock_id='',
        subtype='I',
        contract_size=200,
        strike_price_decimal_locator=0
    ), 
    # ......
} 

---

內期商品合約查詢

透過 get_domestic_contracts 方法查詢指定商品的合約列表（月份、履約價等）。 需傳入 商品代碼 與 類別碼，類別碼請參考 內期商品類別。

期貨合約

# 取得臺指期 (TXF) 期貨 (F) 合約
query_response = unitrade.get_domestic_contracts("TXF", "F")

點擊查看 DomesticContractResponse (期貨) 範例

DomesticContractResponse(
    ok=True, 
    error='', 
    data=[
        DomesticContract(
            prod_id='TXFG5',
            month='202507',
            cp=None,           # 期貨無買賣權
            stikeprice=0,      # 期貨履約價為 0
            maxprice=23815,
            minprice=19485,
            premium=21650,
            divdate='20251217'
        ),  
        # ......
    ]
)

選擇權合約

# 取得臺指選 (TXO) 選擇權 (O) 合約
query_response = unitrade.get_domestic_contracts("TXO", "O")

點擊查看 DomesticContractResponse (選擇權) 範例

DomesticContractResponse(
    ok=True, 
    error='', 
    data=[
        DomesticContract(
            prod_id='TXO15900G5',
            month='202507',
            cp='C',            # C: Call / P: Put
            stikeprice=15900,  # 履約價
            maxprice=7970,
            minprice=3570,
            premium=5770,
            divdate='20251217'
        ),
        # ......
    ]
)

---

外期交易所查詢

透過 get_exchanges 查詢系統支援的外期交易所資訊。

# 外期交易所取得範例 
exchanges = unitrade.get_exchanges()

點擊查看回傳資料結構範例

回傳值為 Dictionary，Key 為交易所代碼。

{
    'CME': EXCHANGE(
        exchange='CME',
        name='芝加哥商品交易所',
        country='USA',
        currency='USD',
        shortname='CME'
    ),
    # ...... 
} 

---

外期商品查詢

透過 get_foreign_products 查詢外期商品清單。

# 外期商品取得範例 
foreign_products = unitrade.get_foreign_products()

點擊查看回傳資料結構範例

回傳值為 Dictionary，Key 為 交易所|商品代碼。

{
    'CBT|10Y': ForeignProduct(
        exchange='CBT',
        symbol='10Y',
        type='F',
        name='微型 10 年收益率期貨',
        shortname='微型十年收益',
        country='USA',
        currency='USD'
    ), 
    # ...... 
} 

---

外期商品合約查詢

透過 get_foreign_contracts 查詢外期商品合約詳細資料。 需傳入 交易所、商品代碼 及 商品類型，代碼請參考 外期商品。

外期期貨合約

# 查詢 CME 交易所, NQ 商品, 期貨 (F) 合約
response = unitrade.get_foreign_contracts("CME", "NQ", "F")

點擊查看 ForeignContractResponse (期貨) 範例

ForeignContractResponse(
    ok=True, 
    error='', 
    data=[
        ForeignContract(
            exchange='CME',
            symbol='NQ',
            type='F',
            monthyear='202506',
            strikeprice='0.0000000',
            cp='',
            lasttradedate='20250620'
        ),
        ForeignContract(
            exchange='CME',
            symbol='NQ',
            type='F',
            monthyear='202509',
            strikeprice='0.0000000',
            cp='',
            lasttradedate='20250919',
            firsttradedate='20251016',
            deliverydate='20260321'
        ),
        # ...... 
    ]
)

外期選擇權合約

# 查詢 CME 交易所, ADO 商品, 選擇權 (O) 合約
response = unitrade.get_foreign_contracts("CME", "ADO", "O")

點擊查看 ForeignContractResponse (選擇權) 範例

ForeignContractResponse(
    ok=True, 
    error='', 
    data=[
        ForeignContract(
            exchange='CME',
            symbol='ADO',
            type='O',
            monthyear='202507',
            strikeprice='1600.0000000',
            cp='C',
            lasttradedate='20250703'
        ),
        ForeignContract(
            exchange='CME',
            symbol='ADO',
            type='O',
            monthyear='202507',
            strikeprice='1600.0000000',
            cp='P',
            lasttradedate='20250919',
            firsttradedate='20251016',
            deliverydate='20260321'
        ),
        # ...... 
    ]
)