期权行权

value TradeClient::check_option_exercise(
    long long contract_id,
    utility::string_t type,
    double quantity,
    utility::string_t executing_date = U(""),
    int is_force = -1,
    int itm_rate = -1,
    utility::string_t account = U("")
)

// 提前行权检验
value result = trade_client->check_option_exercise(
    1234567890LL,    // contract_id
    U("Exercise"),   // type
    1.0,             // quantity
    U("2025-06-20"), // executing_date
    0,               // is_force = false
    -1               // itm_rate = not set
);
ucout << result << endl;

// 提前放弃行权检验，设置价内率
value result2 = trade_client->check_option_exercise(
    1234567890LL,
    U("Expire"),
    1.0,
    U(""),  // executing_date = not set
    -1,     // is_force = not set
    5       // itm_rate = 5
);

{
  "availableQuantity": 5,
  "position": 5,
  "stkPosition": 0,
  "stkPositionChange": 500,
  "stkPositionBefore": 0,
  "stkPositionAfter": 500,
  "symbol": "AAPL"
}

value TradeClient::get_option_exercise_positions(
    utility::string_t type,
    utility::string_t account = U("")
)

value result = trade_client->get_option_exercise_positions(U("Exercise"));
if (result.has_field(U("items")) && result.at(U("items")).is_array()) {
    int64_t item_count = result.at(U("itemCount")).as_number().to_int64();
    ucout << U("itemCount=") << item_count << endl;
    for (auto &pos : result.at(U("items")).as_array()) {
        ucout << U("contractId=") << pos.at(U("contractId")).as_number().to_int64()
              << U(" symbol=") << pos.at(U("symbol")).as_string()
              << U(" availableQty=") << pos.at(U("availableQuantity")).as_double()
              << endl;
    }
}

{
  "pageNum": 1,
  "pageSize": 20,
  "itemCount": 1,
  "pageCount": 1,
  "items": [
    {
      "contractId": 55678,
      "symbol": "AAPL",
      "stkSymbol": "AAPL",
      "expireDate": "20250808",
      "strike": "230",
      "callPut": "CALL",
      "market": "US",
      "accountId": 123,
      "position": 5,
      "availableQuantity": 5
    }
  ]
}

value TradeClient::submit_option_exercise(
    long long contract_id,
    utility::string_t type,
    double quantity,
    utility::string_t executing_date = U(""),
    int is_force = -1,
    int itm_rate = -1,
    utility::string_t account = U("")
)

// 提前行权
value result = trade_client->submit_option_exercise(
    1234567890LL,
    U("Exercise"),
    1.0,
    U("2025-06-20"),
    0,   // is_force = false
    -1
);
bool ok = result.as_bool();
ucout << (ok ? U("提交成功") : U("提交失败")) << endl;

// 提前放弃行权
value result2 = trade_client->submit_option_exercise(
    1234567890LL,
    U("Expire"),
    1.0,
    U(""),  // executing_date = not set
    -1,
    5       // itm_rate = 5
);

true

value TradeClient::get_option_exercise_records(
    utility::string_t exercise_type = U(""),
    utility::string_t status = U(""),
    utility::string_t symbol = U(""),
    utility::string_t order_by = U(""),
    int page = 1,
    int size = 20,
    utility::string_t account = U("")
)

value result = trade_client->get_option_exercise_records(
    U(""),     // exercise_type = all
    U(""),     // status = all
    U(""),     // symbol = all
    U(""),     // order_by = default
    1, 20
);
if (result.has_field(U("items")) && result.at(U("items")).is_array()) {
    for (auto &r : result.at(U("items")).as_array()) {
        ucout << U("id=") << r.at(U("id")).as_number().to_int64()
              << U(" type=") << r.at(U("type")).as_string()
              << U(" status=") << r.at(U("status")).as_string()
              << endl;
    }
}

{
  "pageNum": 1,
  "pageSize": 20,
  "itemCount": 1,
  "pageCount": 1,
  "items": [
    {
      "id": 200001,
      "contractId": 55678,
      "symbol": "AAPL",
      "stkSymbol": "AAPL",
      "expireDate": "20250808",
      "strike": "230",
      "callPut": "CALL",
      "type": "Exercise",
      "requestQuantity": 5,
      "quantity": 5,
      "status": "New",
      "executingDate": "2025-08-08",
      "itmRate": 0,
      "isForce": false,
      "reason": "",
      "accountId": 123
    }
  ]
}

value TradeClient::cancel_option_exercise(
    long long exercise_id,
    utility::string_t account = U("")
)

long long record_id = 987654321LL;  // from get_option_exercise_records
value result = trade_client->cancel_option_exercise(record_id);
bool ok = result.as_bool();
ucout << (ok ? U("撤销成功") : U("撤销失败")) << endl;

true