| | |
|---|
| | | import java.math.BigDecimal; |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 仓位频道处理器。 |
|---|
| | | * 仓位频道处理器（futures.positions）。 |
|---|
| | | * |
|---|
| | | * <h3>数据用途</h3> |
|---|
| | | * 监控仓位数量（size）和入场价（entry_price）。 |
|---|
| | | * 有仓位时（size.abs > 0）：标记方向活跃，记录入场价 → 基底首次成交记录基底入场价并等待生成网格队列， |
|---|
| | | * 非基底成交立即设止盈条件单。无仓位时（size=0）：标记方向不活跃。 |
|---|
| | | * |
|---|
| | | * <h3>推送字段</h3> |
|---|
| | | * contract, mode（dual_long / dual_short）, size（正=多头，负=空头），entry_price |
|---|
| | | * <h3>完整推送字段（共20个，日志全部输出）</h3> |
|---|
| | | * <table> |
|---|
| | | * <tr><th>字段</th><th>类型</th><th>描述</th></tr> |
|---|
| | | * <tr><td>contract</td><td>String</td><td>合约名称</td></tr> |
|---|
| | | * <tr><td>mode</td><td>String</td><td>持仓模式：dual_long / dual_short</td></tr> |
|---|
| | | * <tr><td>size</td><td>String/Integer</td><td>合约张数（正=多头，负=空头）</td></tr> |
|---|
| | | * <tr><td>entry_price</td><td>Float</td><td>开仓均价</td></tr> |
|---|
| | | * <tr><td>cross_leverage_limit</td><td>Float</td><td>全仓模式下的杠杆倍数上限</td></tr> |
|---|
| | | * <tr><td>history_pnl</td><td>Float</td><td>已平仓的仓位总盈亏</td></tr> |
|---|
| | | * <tr><td>history_point</td><td>Float</td><td>已平仓的点卡总盈亏</td></tr> |
|---|
| | | * <tr><td>last_close_pnl</td><td>Float</td><td>最近一次平仓的盈亏</td></tr> |
|---|
| | | * <tr><td>leverage</td><td>Integer</td><td>杠杆倍数（0=全仓，正数=逐仓）</td></tr> |
|---|
| | | * <tr><td>leverage_max</td><td>Integer</td><td>当前风险限额下允许的最大杠杆倍数</td></tr> |
|---|
| | | * <tr><td>liq_price</td><td>Float</td><td>爆仓价格</td></tr> |
|---|
| | | * <tr><td>maintenance_rate</td><td>Float</td><td>当前风险限额下维持保证金比例</td></tr> |
|---|
| | | * <tr><td>margin</td><td>Float</td><td>保证金</td></tr> |
|---|
| | | * <tr><td>realised_pnl</td><td>Float</td><td>已实现盈亏</td></tr> |
|---|
| | | * <tr><td>realised_point</td><td>Float</td><td>点卡已实现盈亏</td></tr> |
|---|
| | | * <tr><td>risk_limit</td><td>Integer</td><td>风险限额</td></tr> |
|---|
| | | * <tr><td>time</td><td>Integer</td><td>更新 unix 时间戳（秒）</td></tr> |
|---|
| | | * <tr><td>time_ms</td><td>Integer</td><td>更新 unix 时间戳（毫秒）</td></tr> |
|---|
| | | * <tr><td>user</td><td>String</td><td>用户 ID</td></tr> |
|---|
| | | * <tr><td>update_id</td><td>Integer</td><td>消息序列号，每次推送 order 后自增1</td></tr> |
|---|
| | | * </table> |
|---|
| | | * |
|---|
| | | * <h3>回调数据（传给 GateGridTradeService）</h3> |
|---|
| | | * mode (Position.ModeEnum), size (BigDecimal), entry_price (BigDecimal) |
|---|
| | | * |
|---|
| | | * <h3>注意</h3> |
|---|
| | | * 双向持仓模式下空头 size 为负数，使用 {@code size.abs()} 判断是否有仓位。 |
|---|
| | |
|---|
| | | |
|---|
| | | private static final String CHANNEL_NAME = "futures.positions"; |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * @param apiKey Gate API v4 密钥，用于签名认证 |
|---|
| | | * @param apiSecret Gate API v4 签名密钥 |
|---|
| | | * @param contract 合约名称（如 ETH_USDT） |
|---|
| | | * @param gridTradeService 网格交易策略服务实例 |
|---|
| | | */ |
|---|
| | | public PositionsChannelHandler(String apiKey, String apiSecret, |
|---|
| | | String contract, |
|---|
| | | GateGridTradeService gridTradeService) { |
|---|
