upctp - CTP Rust 绑定库 v0.10.0

示例清单

#	示例文件	功能
1	`01_market_data.rs`	行情：连接→登录→订阅→接收深度行情
2	`02_trader_auth_login.rs`	交易认证：连接→认证→登录→结算确认
3	`03_query_operations.rs`	查询：合约/持仓/资金/报单/成交/交易所/产品/保证金/手续费
4	`04_order_placement.rs`	报单：限价单→查询最大下单量
5	`05_bank_futures_transfer.rs`	银期转账：银行转期货→查询银行余额
6	`06_order_cancellation.rs`	撤单：报单→接收回报→自动撤单
7	`07_batch_order_cancellation.rs`	批量撤单：多笔报单→批量撤销
8	`08_parked_orders.rs`	预埋单：插入→查询→删除
9	`09_option_execution.rs`	期权行权：行权申报→查询行权
10	`10_option_quote.rs`	期权报价：双边报价→查询报价
11	`11_option_self_close.rs`	期权自对冲：自对冲申报→查询
12	`12_combination_strategy.rs`	组合策略：组合申报→查询组合腿
13	`13_password_change.rs`	密码修改：用户密码→资金密码
14	`14_settlement_query.rs`	结算查询：结算信息→确认状态→公告
15	`md_example.rs`	旧版行情示例

运行示例

# 运行行情示例
cargo run --example 01_market_data

# 运行交易认证示例
cargo run --example 02_trader_auth_login

# 运行查询示例
cargo run --example 03_query_operations

# 运行报单示例
cargo run --example 04_order_placement

# 运行银期转账示例
cargo run --example 05_bank_futures_transfer

示例详解

01_market_data.rs - 行情订阅

演示完整的行情接收流程：创建 MdApi → 注册 SPI → 连接前置 → 登录 → 订阅合约 → 接收深度行情数据推送。

核心回调：on_front_connected(), on_rsp_user_login(), on_rtn_depth_market_data()

02_trader_auth_login.rs - 交易认证登录

演示交易 API 的认证登录流程：创建 TraderApi → 订阅流 → 注册 SPI → 连接前置 → 客户端认证 → 用户登录 → 结算确认。

核心方法：req_authenticate(), req_user_login(), req_settlement_info_confirm()

03_query_operations.rs - 查询操作

演示所有主要查询功能：查询合约信息、投资者持仓、资金账户、报单、成交、交易所、产品、保证金率、手续费率。

核心方法：req_qry_instrument(), req_qry_investor_position(), req_qry_trading_account() 等

04_order_placement.rs - 报单操作

演示限价报单流程：构造报单请求 → 发送报单 → 接收报单回报 → 接收成交回报 → 查询最大下单量。

核心方法：req_order_insert(), req_qry_max_order_volume()

05_bank_futures_transfer.rs - 银期转账

演示银期转账功能：银行转期货（入金）→ 期货转银行（出金）→ 查询银行账户余额。

核心方法：req_from_bank_to_future_by_future(), req_query_bank_account_money_by_future()

06_order_cancellation.rs - 撤单操作

演示报单撤销流程：报单 → 等待 OnRtnOrder 回报 → 自动撤单 → 处理撤单结果。

核心方法：req_order_insert(), req_order_action()

07_batch_order_cancellation.rs - 批量撤单

演示批量撤单功能：放置多笔报单 → 使用 req_batch_order_action() 一次性撤销所有报单。

核心方法：req_order_insert(), req_batch_order_action()

08_parked_orders.rs - 预埋单

演示预埋单功能：插入预埋单 → 查询预埋单 → 删除预埋单。

核心方法：req_parked_order_insert(), req_qry_parked_order(), req_remove_parked_order()

09_option_execution.rs - 期权行权

演示期权行权功能：插入执行宣告 → 查询执行宣告 → 接收行权回报。

核心方法：req_exec_order_insert(), req_qry_exec_order()

10_option_quote.rs - 期权报价

演示期权双边报价功能：插入报价（买价/卖价）→ 查询报价 → 接收报价回报。

核心方法：req_quote_insert(), req_qry_quote()

11_option_self_close.rs - 期权自对冲

演示期权自对冲功能：插入自对冲请求 → 查询自对冲 → 接收自对冲回报。

核心方法：req_option_self_close_insert(), req_qry_option_self_close()

12_combination_strategy.rs - 组合策略

演示组合策略功能：插入组合策略报单 → 查询组合合约保护 → 查询组合腿。

核心方法：req_comb_action_insert(), req_qry_comb_instrument_guard(), req_qry_comb_leg()

13_password_change.rs - 密码修改

演示密码修改功能：修改用户密码 → 修改资金账户密码。

核心方法：req_user_password_update(), req_trading_account_password_update()

14_settlement_query.rs - 结算查询

演示结算信息查询功能：查询结算信息 → 查询结算确认状态 → 查询公告。

核心方法：req_qry_settlement_info(), req_qry_settlement_info_confirm(), req_qry_notice()

SimNow 测试环境配置

所有示例使用以下 SimNow 测试环境凭据：

配置项	值
交易前置	`tcp://182.254.243.31:30001`
行情前置	`tcp://182.254.243.31:30011`
BrokerID	`9999`
用户代码	`你自己的`
用户密码	`你自己的`
APPID	`simnow_client_test`
认证码	`0000000000000000`