預收券款

當現貨觸發一些交易異常條件，需先預收券款。異常條件包括: 注意股票、警示股票、處置股票及管理股票。

提醒

• 必須先登入及啟用憑證。

• 服務時間為交易日8:00~14:30。

查詢圈券狀態

In

var reserveSummary = _api.StockReserveSummary(_api.StockAccount);
Console.WriteLine(reserveSummary);

Out

{
    stocks=[
            contract={
                security_type=STK, 
                code=2890, 
                symbol=TSE2890, 
                exchange=TSE, 
                limit_up=18.45, 
                limit_down=15.15, 
                reference=16.8, 
                margin_trading_balance=0, 
                short_selling_balance=0, 
                update_date=2022/08/05, 
                category=17, 
                day_trade=OnlyBuy, 
                name=永豐金, 
            },
            available_share=5000, 
            reserved_share=0
    ], 
    account={
        "account_type": "S",
        "person_id": "X123456789",
        "broker_id": "9A95",
        "account_id": "12345678",
        "signed": true
    }
}

借券圈券申請

In

_contract = _api.Contracts.Stocks["TSE"]["2890"];
var reserveStock = _api.ReserveStock(_api.StockAccount, _contract, 1000);
Console.WriteLine(reserveStock);

Out

{
    contract={
        security_type=STK, 
        code=2890, 
        symbol=TSE2890, 
        exchange=TSE, 
        limit_up=18.45, 
        limit_down=15.15, 
        reference=16.8, 
        margin_trading_balance=0, 
        short_selling_balance=0, 
        update_date=2022/08/05, 
        category=17, 
        day_trade=OnlyBuy, 
        name=永豐金, 
    }, 
    account={
        "account_type": "S",
        "person_id": "X123456789",
        "broker_id": "9A95",
        "account_id": "12345678",
        "signed": true
    }, 
    share=1000, 
    status=True, 
    info="", 
}

查詢圈券明細

In

var reserveDetail = _api.StockReserveDetail(_api.StockAccount);
Console.WriteLine(reserveDetail);

Out

{
    stocks=[
            contract={
                security_type=STK, 
                code=2890, 
                symbol=TSE2890, 
                exchange=TSE, 
                limit_up=18.45, 
                limit_down=15.15, 
                reference=16.8, 
                margin_trading_balance=0, 
                short_selling_balance=0, 
                update_date=2022/08/05, 
                category=17, 
                day_trade=OnlyBuy, 
                name=永豐金, 
            },
            share=1000,
            order_datetime=1638253253, 
            status=True, 
            info="已完成"
    ], 
    account={
        "account_type": "S",
        "person_id": "X123456789",
        "broker_id": "9A95",
        "account_id": "12345678",
        "signed": true
    }
}

預收款項申請

In

_contract = _api.Contracts.Stocks["TSE"]["2890"];
var reserveEarmarking = _api.ReserveEarmarking(_api.StockAccount, _contract, 1000, 15.5);
Console.WriteLine(reserveEarmarking);

Out

{
    contract={
        security_type=STK, 
        code=2890, symbol=TSE2890, exchange=TSE, limit_up=18.45, limit_down=15.15, reference=16.8, margin_trading_balance=0, short_selling_balance=0, update_date=2022/08/05, category=17, day_trade=OnlyBuy, name=永豐金, 
    }, 
    account={
        "account_type": "S",
        "person_id": "X123456789",
        "broker_id": "9A95",
        "account_id": "12345678",
        "signed": true
    }, 
    share=1000, 
    price=15.5, 
    status=True, 
    info=OK, 
}

查詢預收款項

In

var earmarkingDetail = _api.EarmarkingDetail(_api.StockAccount);
Console.WriteLine(earmarkingDetail);

Out

{
    stocks=[
        {
            contract={
                "security_type": "STK",
                "exchange": "TSE",
                "code": "2890",
                "symbol": "",
                "name": "永豐金",
                "currency": "TWD",
                "category": "",
                "delivery_month": "",
                "delivery_date": "",
                "strike_price": 0,
                "option_right": "",
                "underlying_kind": "",
                "underlying_code": "",
                "unit": 1,
                "multiplier": 0,
                "limit_up": 0.0,
                "limit_down": 0.0,
                "reference": 0.0,
                "update_date": "",
                "day_trade": "No",
                "margin_trading_balance": 0,
                "short_selling_balance": 0
            }, 
            share=1000, 
            price=15.5, 
            amount=15522, 
            order_datetime=2022/8/5 上午 10:24:32, 
            status=True, 
            info=成功, 
        }
    ], 
    account={
        "account_type": "S",
        "person_id": "A226237733",
        "broker_id": "9A95",
        "account_id": "9816939",
        "signed": true
    }, 
}