fyers 0.2.1

Idiomatic async Rust client for the Fyers trading API.
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

use serde::Deserialize;

use crate::models::orders::place_order_request::OrderRequest;
use crate::{Fyers, FyersError, Order};

impl Fyers {
    /// Place a single order.
    ///
    /// Returns the placed [`Order`] on success.
    ///
    /// Use [`OrderRequest::builder`] to construct the order.
    ///
    /// # Example
    /// ```no_run
    /// use fyers::{OrderRequest, OrderType, Side, ProductType, Validity};
    /// # use fyers::Fyers;
    ///
    /// # async fn run() -> Result<(), Box<dyn std::error::Error>> {
    /// # let fyers = Fyers::new("id", "token");
    /// let order = OrderRequest::builder(
    ///    "NSE:JIOFIN-EQ",
    ///    1,
    ///    OrderType::Market,
    ///    Side::Buy,
    ///    ProductType::Intraday,
    ///    Validity::Day,
    /// )
    /// .offline_order(true) // Optional args here
    /// .build(); // build the request
    ///
    /// let order = fyers.place_order(&order).await?;
    /// println!("{order:?}");
    /// # Ok(())
    /// # }
    /// ```
    pub async fn place_order(&self, order: &OrderRequest) -> Result<Order, FyersError> {
        let url = format!("{}/orders/sync", self.base_urls.api_v3);
        let response = self.post(&url, order).await?;
        Ok(Order::deserialize(response)?)
    }
}