binance-sdk 45.0.0

This is a lightweight library that works as a connector to the Binance public API.
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
134

pub mod rest_api;

pub mod websocket_streams;

use crate::common::{
    config::{ConfigurationRestApi, ConfigurationWebsocketStreams},
    constants::{
        DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL,
        DERIVATIVES_TRADING_OPTIONS_REST_API_TESTNET_URL,
        DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL,
        DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_TESTNET_URL,
    },
    utils::build_user_agent,
};

/// Represents the `DerivativesTradingOptions` REST API client for interacting with the Binance `DerivativesTradingOptions` REST API.
///
/// This struct provides methods to create REST API clients for production  and testnet environments.
pub struct DerivativesTradingOptionsRestApi {}

impl DerivativesTradingOptionsRestApi {
    /// Creates a REST API client with the given configuration.
    ///
    /// If no base path is specified in the configuration, defaults to the production `DerivativesTradingOptions` REST API URL.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the REST API client
    ///
    /// # Returns
    ///
    /// A new REST API client configured with the provided settings
    #[must_use]
    pub fn from_config(mut config: ConfigurationRestApi) -> rest_api::RestApi {
        config.user_agent = build_user_agent("derivatives-trading-options");
        if config.base_path.is_none() {
            config.base_path = Some(DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL.to_string());
        }
        rest_api::RestApi::new(config)
    }

    /// Creates a REST API client configured for the production environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the REST API client
    ///
    /// # Returns
    ///
    /// A new REST API client configured for the production environment
    #[must_use]
    pub fn production(mut config: ConfigurationRestApi) -> rest_api::RestApi {
        config.base_path = Some(DERIVATIVES_TRADING_OPTIONS_REST_API_PROD_URL.to_string());
        DerivativesTradingOptionsRestApi::from_config(config)
    }

    /// Creates a REST API client configured for the testnet environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the REST API client
    ///
    /// # Returns
    ///
    /// A new REST API client configured for the testnet environment
    #[must_use]
    pub fn testnet(mut config: ConfigurationRestApi) -> rest_api::RestApi {
        config.base_path = Some(DERIVATIVES_TRADING_OPTIONS_REST_API_TESTNET_URL.to_string());
        DerivativesTradingOptionsRestApi::from_config(config)
    }
}

/// Represents the `DerivativesTradingOptions` WebSocket Streams client for interacting with the Binance `DerivativesTradingOptions` WebSocket Streams.
///
/// This struct provides methods to create WebSocket Streams clients for production  and testnet environments.
pub struct DerivativesTradingOptionsWsStreams {}

impl DerivativesTradingOptionsWsStreams {
    /// Creates a WebSocket streams client configured with the given settings.
    ///
    /// If no WS URL is specified in the configuration, defaults to the production `DerivativesTradingOptions` WebSocket Streams URL.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket streams client
    ///
    /// # Returns
    ///
    /// A new WebSocket streams client configured with the provided settings
    #[must_use]
    pub fn from_config(
        mut config: ConfigurationWebsocketStreams,
    ) -> websocket_streams::WebsocketStreamsHandle {
        config.user_agent = build_user_agent("derivatives-trading-options");
        if config.ws_url.is_none() {
            config.ws_url = Some(DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL.to_string());
        }
        websocket_streams::WebsocketStreamsHandle::new(config)
    }

    /// Creates a WebSocket streams client configured for the production environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket streams client
    ///
    /// # Returns
    ///
    /// A new WebSocket streams client configured for the production environment
    #[must_use]
    pub fn production(
        mut config: ConfigurationWebsocketStreams,
    ) -> websocket_streams::WebsocketStreamsHandle {
        config.ws_url = Some(DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_PROD_URL.to_string());
        DerivativesTradingOptionsWsStreams::from_config(config)
    }

    /// Creates a WebSocket streams client configured for the testnet environment.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the WebSocket streams client
    ///
    /// # Returns
    ///
    /// A new WebSocket streams client configured for the testnet environment
    #[must_use]
    pub fn testnet(
        mut config: ConfigurationWebsocketStreams,
    ) -> websocket_streams::WebsocketStreamsHandle {
        config.ws_url = Some(DERIVATIVES_TRADING_OPTIONS_WS_STREAMS_TESTNET_URL.to_string());
        DerivativesTradingOptionsWsStreams::from_config(config)
    }
}