feat: add MetaAndAssetContexts to achieve `Retrieve perpetuals asset … (#103)

…contexts (includes mark price, current funding, open interest, etc.)`

Author: llvm-x86

src/bin/info.rs

@@ -13,6 +13,7 @@ async fn main() {
     user_states_example(&info_client).await;
     recent_trades(&info_client).await;
     meta_example(&info_client).await;
+    meta_and_asset_contexts_example(&info_client).await;
     all_mids_example(&info_client).await;
     user_fills_example(&info_client).await;
     funding_history_example(&info_client).await;
@@ -87,7 +88,14 @@ async fn recent_trades(info_client: &InfoClient) {
 }
 
 async fn meta_example(info_client: &InfoClient) {
-    info!("Metadata: {:?}", info_client.meta().await.unwrap());
+    info!("Meta: {:?}", info_client.meta().await.unwrap());
+}
+
+async fn meta_and_asset_contexts_example(info_client: &InfoClient) {
+    info!(
+        "Meta and asset contexts: {:?}",
+        info_client.meta_and_asset_contexts().await.unwrap()
+    );
 }
 
 async fn all_mids_example(info_client: &InfoClient) {

src/info/info_client.rs

@@ -3,7 +3,7 @@ use crate::{
         CandlesSnapshotResponse, FundingHistoryResponse, L2SnapshotResponse, OpenOrdersResponse,
         OrderInfo, RecentTradesResponse, UserFillsResponse, UserStateResponse,
     },
-    meta::{Meta, SpotMeta, SpotMetaAndAssetCtxs},
+    meta::{AssetContext, Meta, SpotMeta, SpotMetaAndAssetCtxs},
     prelude::*,
     req::HttpClient,
     ws::{Subscription, WsManager},
@@ -53,6 +53,7 @@ pub enum InfoRequest {
         oid: u64,
     },
     Meta,
+    MetaAndAssetCtxs,
     SpotMeta,
     SpotMetaAndAssetCtxs,
     AllMids,
@@ -205,6 +206,11 @@ impl InfoClient {
         self.send_info_request(input).await
     }
 
+    pub async fn meta_and_asset_contexts(&self) -> Result<(Meta, Vec<AssetContext>)> {
+        let input = InfoRequest::MetaAndAssetCtxs;
+		self.send_info_request(input).await
+    }
+
     pub async fn spot_meta(&self) -> Result<SpotMeta> {
         let input = InfoRequest::SpotMeta;
         self.send_info_request(input).await

src/lib.rs

@@ -17,5 +17,5 @@ pub use exchange::*;
 pub use helpers::{bps_diff, truncate_float, BaseUrl};
 pub use info::{info_client::*, *};
 pub use market_maker::{MarketMaker, MarketMakerInput, MarketMakerRestingOrder};
-pub use meta::{AssetMeta, Meta, SpotAssetMeta, SpotMeta};
+pub use meta::{AssetContext, AssetMeta, Meta, MetaAndAssetCtxs, SpotAssetMeta, SpotMeta};
 pub use ws::*;

src/meta.rs

@@ -52,6 +52,13 @@ pub enum SpotMetaAndAssetCtxs {
     Context(Vec<SpotAssetContext>),
 }
 
+#[derive(Deserialize, Debug, Clone)]
+#[serde(untagged)]
+pub enum MetaAndAssetCtxs {
+    Meta(Meta),
+    Context(Vec<AssetContext>),
+}
+
 #[derive(Deserialize, Debug, Clone)]
 #[serde(rename_all = "camelCase")]
 pub struct SpotAssetContext {
@@ -63,11 +70,28 @@ pub struct SpotAssetContext {
     pub coin: String,
 }
 
+#[derive(Deserialize, Debug, Clone)]
+#[serde(rename_all = "camelCase")]
+pub struct AssetContext {
+    pub day_ntl_vlm: String,
+    pub funding: String,
+    pub impact_pxs: Vec<String>,
+    pub mark_px: String,
+    pub mid_px: Option<String>,
+    pub open_interest: String,
+    pub oracle_px: String,
+    pub premium: String,
+    pub prev_day_px: String,
+}
+
 #[derive(Deserialize, Debug, Clone)]
 #[serde(rename_all = "camelCase")]
 pub struct AssetMeta {
     pub name: String,
     pub sz_decimals: u32,
+    pub max_leverage: usize,
+    #[serde(default)]
+    pub only_isolated: Option<bool>,
 }
 
 #[derive(Deserialize, Debug, Clone)]