bybit-rust-api 0.4.0

Complete Rust SDK for Bybit API V5 with all endpoints, comprehensive type safety and full test coverage
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

//! Position stream — real-time position updates.
//!
//! # Topics
//! - `position` (all categories)
//! - `position.linear`, `position.inverse`, `position.option`

use serde::Deserialize;

/// Position data from private WebSocket.
#[derive(Debug, Clone, Deserialize)]
pub struct PositionData {
    /// Position index (0 = one-way, 1/2 = hedge mode)
    #[serde(rename = "positionIdx")]
    #[serde(default)]
    pub position_idx: Option<i32>,
    /// Risk ID
    #[serde(rename = "riskId")]
    #[serde(default)]
    pub risk_id: Option<i32>,
    /// Symbol
    #[serde(rename = "symbol")]
    #[serde(default)]
    pub symbol: Option<String>,
    /// Side: "Buy" or "Sell" (empty for spot)
    #[serde(rename = "side")]
    #[serde(default)]
    pub side: Option<String>,
    /// Position size
    #[serde(rename = "size")]
    #[serde(default)]
    pub size: Option<String>,
    /// Position value
    #[serde(rename = "positionValue")]
    #[serde(default)]
    pub position_value: Option<String>,
    /// Entry price
    #[serde(rename = "entryPrice")]
    #[serde(default)]
    pub entry_price: Option<String>,
    /// Trade mode: 0=cross, 1=isolated
    #[serde(rename = "tradeMode")]
    #[serde(default)]
    pub trade_mode: Option<i32>,
    /// Auto add margin: 0=off, 1=on
    #[serde(rename = "autoAddMargin")]
    #[serde(default)]
    pub auto_add_margin: Option<i32>,
    /// Leverage
    #[serde(rename = "leverage")]
    #[serde(default)]
    pub leverage: Option<String>,
    /// Position status: "Normal", "Liq", "Adl"
    #[serde(rename = "positionStatus")]
    #[serde(default)]
    pub position_status: Option<String>,
    /// Mark price
    #[serde(rename = "markPrice")]
    #[serde(default)]
    pub mark_price: Option<String>,
    /// Liquidation price
    #[serde(rename = "liqPrice")]
    #[serde(default)]
    pub liq_price: Option<String>,
    /// Bankruptcy price
    #[serde(rename = "bustPrice")]
    #[serde(default)]
    pub bust_price: Option<String>,
    /// Unrealised PnL
    #[serde(rename = "unrealisedPnl")]
    #[serde(default)]
    pub unrealised_pnl: Option<String>,
    /// Cumulative realised PnL
    #[serde(rename = "cumRealisedPnl")]
    #[serde(default)]
    pub cum_realised_pnl: Option<String>,
    /// Take profit price
    #[serde(rename = "takeProfit")]
    #[serde(default)]
    pub take_profit: Option<String>,
    /// Stop loss price
    #[serde(rename = "stopLoss")]
    #[serde(default)]
    pub stop_loss: Option<String>,
    /// Trailing stop
    #[serde(rename = "trailingStop")]
    #[serde(default)]
    pub trailing_stop: Option<String>,
    /// Position IM (initial margin)
    #[serde(rename = "positionIM")]
    #[serde(default)]
    pub position_im: Option<String>,
    /// Position MM (maintenance margin)
    #[serde(rename = "positionMM")]
    #[serde(default)]
    pub position_mm: Option<String>,
    /// Created timestamp
    #[serde(rename = "createdTime")]
    #[serde(default)]
    pub created_time: Option<String>,
    /// Updated timestamp
    #[serde(rename = "updatedTime")]
    #[serde(default)]
    pub updated_time: Option<String>,
    /// Category
    #[serde(rename = "category")]
    #[serde(default)]
    pub category: Option<String>,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_parse_position() {
        let json = serde_json::json!({
            "positionIdx": 0,
            "symbol": "BTCUSDT",
            "side": "Buy",
            "size": "0.5",
            "entryPrice": "50000.00",
            "markPrice": "50100.00",
            "unrealisedPnl": "50.00",
            "leverage": "10",
            "category": "linear"
        });

        let pos: PositionData = serde_json::from_value(json).unwrap();
        assert_eq!(pos.symbol.as_deref(), Some("BTCUSDT"));
        assert_eq!(pos.side.as_deref(), Some("Buy"));
        assert_eq!(pos.size.as_deref(), Some("0.5"));
    }
}