use serde::Deserialize;
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct Instrument {
#[serde(default)]
pub inst_type: String,
#[serde(default)]
pub series_id: Option<String>,
#[serde(default)]
pub inst_id: String,
#[serde(default)]
pub uly: String,
#[serde(default)]
pub inst_family: String,
#[serde(default)]
pub category: String,
#[serde(default)]
pub base_ccy: String,
#[serde(default)]
pub quote_ccy: String,
#[serde(default)]
pub settle_ccy: String,
#[serde(default)]
pub ct_val: String,
#[serde(default)]
pub ct_mult: String,
#[serde(default)]
pub ct_val_ccy: String,
#[serde(default)]
pub opt_type: String,
#[serde(default)]
pub stk: String,
#[serde(default)]
pub list_time: String,
#[serde(default)]
pub exp_time: String,
#[serde(default)]
pub lever: String,
#[serde(default)]
pub tick_sz: String,
#[serde(default)]
pub lot_sz: String,
#[serde(default)]
pub min_sz: String,
#[serde(default)]
pub ct_type: String,
#[serde(default)]
pub alias: String,
#[serde(default)]
pub state: String,
#[serde(default)]
pub max_lmt_sz: String,
#[serde(default)]
pub max_mkt_sz: String,
#[serde(default)]
pub max_twap_sz: String,
#[serde(default)]
pub max_iceberg_sz: String,
#[serde(default)]
pub max_trigger_sz: String,
#[serde(default)]
pub max_stop_sz: String,
#[serde(default)]
pub inst_id_code: Option<u64>,
#[serde(default)]
pub rpi_min_level: Option<String>,
#[serde(default)]
pub rpi_min_px_band: Option<String>,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct EventContractSettlement {
pub method: String,
pub close_early: bool,
pub src_name: String,
pub underlying: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct EventContractSeries {
pub series_id: String,
pub freq: String,
pub title: String,
pub category: String,
pub settlement: EventContractSettlement,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct EventContractEvent {
pub series_id: String,
pub event_id: String,
pub exp_time: String,
pub state: String,
#[serde(default)]
pub fix_time: Option<String>,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct EventContractMarket {
pub series_id: String,
pub event_id: String,
pub inst_id: String,
pub list_time: String,
pub exp_time: String,
pub state: String,
pub fix_time: String,
pub outcome: String,
pub floor_strike: String,
#[serde(default)]
pub cap_strike: Option<String>,
#[serde(default)]
pub hit_dir: Option<String>,
pub settle_value: String,
pub disputed: bool,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct FundingRate {
#[serde(default)]
pub inst_type: String,
#[serde(default)]
pub inst_id: String,
#[serde(default)]
pub funding_rate: String,
#[serde(default)]
pub realized_rate: String,
#[serde(default)]
pub funding_time: String,
#[serde(default)]
pub next_funding_rate: String,
#[serde(default)]
pub next_funding_time: String,
#[serde(default)]
pub min_funding_rate: String,
#[serde(default)]
pub max_funding_rate: String,
#[serde(default)]
pub method: String,
#[serde(default)]
pub premium: String,
#[serde(default)]
pub settle_state: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct MarkPrice {
#[serde(default)]
pub inst_type: String,
#[serde(default)]
pub inst_id: String,
#[serde(default)]
pub mark_px: String,
#[serde(default)]
pub ts: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct OpenInterest {
#[serde(default)]
pub inst_type: String,
#[serde(default)]
pub inst_id: String,
#[serde(default)]
pub oi: String,
#[serde(default)]
pub oi_ccy: String,
#[serde(default)]
pub ts: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct ServerTime {
#[serde(default)]
pub ts: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct PositionTier {
#[serde(default)]
pub uly: String,
#[serde(default)]
pub inst_id: String,
#[serde(default)]
pub tier: String,
#[serde(default)]
pub min_sz: String,
#[serde(default)]
pub max_sz: String,
#[serde(default)]
pub mmr: String,
#[serde(default)]
pub imr: String,
#[serde(default)]
pub max_lever: String,
#[serde(default)]
pub opt_mrgn_factor: String,
#[serde(default)]
pub quote_max_loan: String,
#[serde(default)]
pub base_max_loan: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct InsuranceFund {
#[serde(default)]
pub total: String,
#[serde(default)]
pub details: Vec<InsuranceFundDetail>,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct InsuranceFundDetail {
#[serde(default)]
pub amt: String,
#[serde(default)]
pub ccy: String,
#[serde(default, rename = "type")]
pub type_: String,
#[serde(default)]
pub ts: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct UnitConvertResult {
#[serde(default, rename = "type")]
pub type_: String,
#[serde(default)]
pub inst_id: String,
#[serde(default)]
pub px: String,
#[serde(default)]
pub sz: String,
#[serde(default)]
pub unit: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct DeliveryExerciseHistory {
#[serde(default)]
pub ts: String,
#[serde(default)]
pub details: Vec<DeliveryDetail>,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct DeliveryDetail {
#[serde(default, rename = "type")]
pub type_: String,
#[serde(default)]
pub inst_id: String,
#[serde(default)]
pub px: String,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct DiscountRate {
#[serde(default)]
pub ccy: String,
#[serde(default)]
pub amt: String,
#[serde(default)]
pub discount_lv: String,
#[serde(default)]
pub discount_info: Vec<DiscountInfo>,
}
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
#[non_exhaustive]
pub struct DiscountInfo {
#[serde(default)]
pub discount_rate: String,
#[serde(default)]
pub max_amt: String,
#[serde(default)]
pub min_amt: String,
}
#[derive(Debug, Clone, Deserialize, Default)]
#[serde(default, rename_all = "camelCase")]
#[non_exhaustive]
pub struct MarketDataHistoryFile {
pub date_ts: String,
pub filename: String,
#[serde(rename = "sizeMB")]
pub size_mb: String,
pub url: String,
}
#[derive(Debug, Clone, Deserialize, Default)]
#[serde(default, rename_all = "camelCase")]
#[non_exhaustive]
pub struct MarketDataHistoryGroup {
pub inst_id: String,
pub inst_family: String,
pub inst_type: String,
pub date_range_start: String,
pub date_range_end: String,
#[serde(rename = "groupSizeMB")]
pub group_size_mb: String,
pub group_details: Vec<MarketDataHistoryFile>,
}
#[derive(Debug, Clone, Deserialize, Default)]
#[serde(default, rename_all = "camelCase")]
#[non_exhaustive]
pub struct MarketDataHistoryResult {
pub date_aggr_type: String,
pub details: Vec<MarketDataHistoryGroup>,
#[serde(rename = "totalSizeMB")]
pub total_size_mb: String,
pub ts: String,
}
#[derive(Debug, Clone, Deserialize, Default)]
#[serde(default, rename_all = "camelCase")]
#[non_exhaustive]
pub struct MmInstrumentType {
pub inst_id: String,
pub inst_type: String,
pub pair_type: String,
}
#[derive(Debug, Clone, Deserialize, Default)]
#[serde(default, rename_all = "camelCase")]
#[non_exhaustive]
pub struct Announcement {
pub ann_type: String,
pub ann_title: String,
pub ann_url: String,
pub p_time: String,
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn event_contract_fields_deserialize() {
let instrument: Instrument = serde_json::from_value(serde_json::json!({
"instType": "EVENTS",
"instId": "BTC-ABOVE-DAILY-1",
"seriesId": "BTC-ABOVE-DAILY",
"instIdCode": 42,
"rpiMinLevel": "4",
"rpiMinPxBand": "10"
}))
.unwrap();
let series: EventContractSeries = serde_json::from_value(serde_json::json!({
"seriesId": "BTC-ABOVE-DAILY",
"freq": "daily",
"title": "Bitcoin above",
"category": "crypto",
"settlement": {
"method": "above",
"closeEarly": false,
"srcName": "OKX",
"underlying": "BTC-USDT"
}
}))
.unwrap();
let market: EventContractMarket = serde_json::from_value(serde_json::json!({
"seriesId": "BTC-ABOVE-DAILY",
"eventId": "event-1",
"instId": "BTC-ABOVE-DAILY-1",
"listTime": "1",
"expTime": "2",
"state": "live",
"fixTime": "",
"outcome": "yes",
"floorStrike": "100000",
"capStrike": "INF",
"hitDir": "up",
"settleValue": "",
"disputed": false
}))
.unwrap();
assert_eq!(instrument.series_id.as_deref(), Some("BTC-ABOVE-DAILY"));
assert_eq!(instrument.inst_id_code, Some(42));
assert_eq!(instrument.rpi_min_level.as_deref(), Some("4"));
assert_eq!(instrument.rpi_min_px_band.as_deref(), Some("10"));
assert_eq!(series.settlement.method, "above");
assert_eq!(market.outcome, "yes");
assert_eq!(market.cap_strike.as_deref(), Some("INF"));
assert_eq!(market.hit_dir.as_deref(), Some("up"));
}
}