digdigdig3 0.3.16

//! # Bitget Endpoints
//!
//! URL'ы и endpoint enum для Bitget API.

use crate::core::types::AccountType;

// ═══════════════════════════════════════════════════════════════════════════════
// URLs
// ═══════════════════════════════════════════════════════════════════════════════

/// URL'ы для Bitget API
#[derive(Debug, Clone)]
pub struct BitgetUrls {
    pub spot_rest: &'static str,
    pub futures_rest: &'static str,
    pub ws_public: &'static str,
    pub ws_private: &'static str,
}

impl BitgetUrls {
    /// Production URLs
    pub const MAINNET: Self = Self {
        spot_rest: "https://api.bitget.com",
        futures_rest: "https://api.bitget.com",
        ws_public: "wss://ws.bitget.com/v2/ws/public",
        ws_private: "wss://ws.bitget.com/v2/ws/private",
    };

    /// Demo / paper-trading URLs.
    ///
    /// Bitget demo trading ("simulated trading") uses the same REST base URLs
    /// as mainnet.  Authenticated REST requests must include the header
    /// `X-CHANNEL-API-CODE: paptrading`.  WebSocket connections use the
    /// dedicated `wspap.bitget.com` domain.
    pub const TESTNET: Self = Self {
        spot_rest: "https://api.bitget.com",
        futures_rest: "https://api.bitget.com",
        ws_public: "wss://wspap.bitget.com/v2/ws/public",
        ws_private: "wss://wspap.bitget.com/v2/ws/private",
    };

    /// Получить REST base URL для account type
    pub fn rest_url(&self, account_type: AccountType) -> &str {
        match account_type {
            AccountType::Spot | AccountType::Margin => self.spot_rest,
            AccountType::FuturesCross | AccountType::FuturesIsolated => self.futures_rest,
            _ => self.spot_rest,
        }
    }

    /// Получить WebSocket public URL
    pub fn ws_public_url(&self) -> String {
        self.ws_public.to_string()
    }

    /// Получить WebSocket private URL
    pub fn ws_private_url(&self) -> String {
        self.ws_private.to_string()
    }
}

// ═══════════════════════════════════════════════════════════════════════════════
// ENDPOINTS
// ═══════════════════════════════════════════════════════════════════════════════

/// Bitget API endpoints
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum BitgetEndpoint {
    // === ОБЩИЕ ===
    Timestamp,

    // === SPOT MARKET DATA ===
    SpotPrice,
    SpotOrderbook,
    SpotKlines,
    SpotTicker,
    SpotAllTickers,
    SpotSymbols,

    // === SPOT TRADING ===
    SpotCreateOrder,
    SpotCancelOrder,
    SpotGetOrder,
    SpotOpenOrders,
    SpotAllOrders,

    // === SPOT ACCOUNT ===
    SpotAccounts,
    SpotAccountInfo,

    // === FUTURES MARKET DATA ===
    FuturesPrice,
    FuturesOrderbook,
    FuturesKlines,
    FuturesTicker,
    FuturesAllTickers,
    FuturesContracts,
    FundingRate,

    // === FUTURES TRADING ===
    FuturesCreateOrder,
    FuturesCancelOrder,
    FuturesGetOrder,
    FuturesOpenOrders,
    FuturesAllOrders,
    FuturesBatchPlaceOrders,
    FuturesBatchCancelOrders,
    FuturesCancelBySymbol,
    FuturesClosePositions,
    FuturesModifyOrder,
    FuturesPlanOrder,
    FuturesPosTpSl,

    // === FUTURES ACCOUNT ===
    FuturesAccount,
    FuturesAllAccounts,
    FuturesPositions,
    FuturesPosition,
    FuturesSetLeverage,
    FuturesSetMarginMode,
    FuturesSetMargin,

    // === FUTURES ALGO ===
    /// TWAP algorithmic order — `POST /api/v2/mix/order/place-twap-order`
    FuturesTwapOrder,

    // === SPOT EXTRA ===
    SpotBatchPlaceOrders,
    SpotBatchCancelOrders,
    SpotCancelBySymbol,
    SpotModifyOrder,
    SpotFills,

    // === COMMON ===
    TradeRate,
    VipFeeRate,

    // === TRANSFERS ===
    Transfer,                    // POST /api/v2/spot/wallet/transfer
    TransferHistory,             // GET  /api/v2/spot/account/transferRecords

    // === CUSTODIAL FUNDS ===
    DepositAddress,              // GET  /api/v2/spot/wallet/deposit-address
    Withdraw,                    // POST /api/v2/spot/wallet/withdrawal
    DepositHistory,              // GET  /api/v2/spot/wallet/deposit-records
    WithdrawHistory,             // GET  /api/v2/spot/wallet/withdrawal-records

    // === SUB ACCOUNTS ===
    SubAccountCreate,            // POST /api/v2/user/create-virtual-subaccount
    SubAccountList,              // GET  /api/v2/user/virtual-subaccount-list
    SubAccountTransfer,          // POST /api/v2/user/virtual-subaccount-transfer
    SubAccountAssets,            // GET  /api/v2/user/virtual-subaccount-assets

    // === EXTENDED ENDPOINTS ===
    /// GET /api/v2/spot/market/fills — recent public spot fills
    SpotRecentFills,
    /// GET /api/v2/spot/market/history-candles — historical candles beyond the standard window
    SpotHistoryCandles,
    /// GET /api/v2/mix/order/fill-history — futures fill/trade history (signed)
    FuturesFillHistory,
    /// GET /api/v2/mix/market/open-interest — futures open interest
    FuturesOpenInterest,
    /// GET /api/v2/mix/market/history-fund-rate — futures historical funding rates
    FuturesFundingRateHistory,
    /// GET /api/v2/mix/market/symbol-price — futures mark/index price
    FuturesSymbolPrice,
    /// GET /api/v2/spot/account/bills — spot account bill/ledger records
    SpotBills,

    // === NEW MARKET DATA ===
    /// GET /api/v2/mix/market/fills-history — recent public futures fills
    FuturesMarketFills,
    /// GET /api/v2/mix/market/history-mark-candles — mark price OHLCV history
    FuturesMarkCandles,
    /// GET /api/v2/mix/market/history-index-candles — index price OHLCV history
    FuturesIndexCandles,
    /// GET /api/v2/mix/market/long-short — global long/short ratio history
    FuturesLongShort,
    /// GET /api/v2/mix/market/account-long-short — account-count long/short ratio history
    FuturesAccountLongShort,
    /// GET /api/v2/mix/market/taker-buy-sell — taker buy/sell volume history.
    /// Response fields: `{ sellVolume, buyVolume, ts }` (all string-encoded, ts in ms).
    FuturesTakerBuySell,
}

impl BitgetEndpoint {
    /// Получить путь endpoint'а (V2 API)
    pub fn path(&self) -> &'static str {
        match self {
            // Общие
            Self::Timestamp => "/api/v2/public/time",

            // Spot Market Data
            Self::SpotPrice => "/api/v2/spot/market/tickers",
            Self::SpotOrderbook => "/api/v2/spot/market/orderbook",
            Self::SpotKlines => "/api/v2/spot/market/candles",
            Self::SpotTicker => "/api/v2/spot/market/tickers",
            Self::SpotAllTickers => "/api/v2/spot/market/tickers",
            Self::SpotSymbols => "/api/v2/spot/public/symbols",

            // Spot Trading
            Self::SpotCreateOrder => "/api/v2/spot/trade/place-order",
            Self::SpotCancelOrder => "/api/v2/spot/trade/cancel-order",
            Self::SpotGetOrder => "/api/v2/spot/trade/orderInfo",
            Self::SpotOpenOrders => "/api/v2/spot/trade/unfilled-orders",
            Self::SpotAllOrders => "/api/v2/spot/trade/history-orders",

            // Spot Account
            Self::SpotAccounts => "/api/v2/spot/account/assets",
            Self::SpotAccountInfo => "/api/v2/spot/account/info",

            // Futures Market Data
            Self::FuturesPrice => "/api/v2/mix/market/ticker",
            Self::FuturesOrderbook => "/api/v2/mix/market/merge-depth",
            Self::FuturesKlines => "/api/v2/mix/market/candles",
            Self::FuturesTicker => "/api/v2/mix/market/ticker",
            Self::FuturesAllTickers => "/api/v2/mix/market/tickers",
            Self::FuturesContracts => "/api/v2/mix/market/contracts",
            Self::FundingRate => "/api/v2/mix/market/current-fund-rate",

            // Futures Trading
            Self::FuturesCreateOrder => "/api/v2/mix/order/place-order",
            Self::FuturesCancelOrder => "/api/v2/mix/order/cancel-order",
            Self::FuturesGetOrder => "/api/v2/mix/order/detail",
            Self::FuturesOpenOrders => "/api/v2/mix/order/orders-pending",
            Self::FuturesAllOrders => "/api/v2/mix/order/orders-history",
            Self::FuturesBatchPlaceOrders => "/api/v2/mix/order/batch-place-order",
            Self::FuturesBatchCancelOrders => "/api/v2/mix/order/batch-cancel-orders",
            Self::FuturesCancelBySymbol => "/api/v2/mix/order/cancel-all-orders",
            Self::FuturesClosePositions => "/api/v2/mix/order/close-positions",
            Self::FuturesModifyOrder => "/api/v2/mix/order/modify-order",
            Self::FuturesPlanOrder => "/api/v2/mix/order/place-plan-order",
            Self::FuturesPosTpSl => "/api/v2/mix/order/place-tpsl-order",

            // Futures Account
            Self::FuturesAccount => "/api/v2/mix/account/account",
            Self::FuturesAllAccounts => "/api/v2/mix/account/accounts",
            Self::FuturesPositions => "/api/v2/mix/position/all-position",
            Self::FuturesPosition => "/api/v2/mix/position/single-position",
            Self::FuturesSetLeverage => "/api/v2/mix/account/set-leverage",
            Self::FuturesSetMarginMode => "/api/v2/mix/account/set-margin-mode",
            Self::FuturesSetMargin => "/api/v2/mix/account/set-margin",

            // Futures Algo
            Self::FuturesTwapOrder => "/api/v2/mix/order/place-twap-order",

            // Spot Extra
            Self::SpotBatchPlaceOrders => "/api/v2/spot/trade/batch-orders",
            Self::SpotBatchCancelOrders => "/api/v2/spot/trade/batch-cancel-order",
            Self::SpotCancelBySymbol => "/api/v2/spot/trade/cancel-symbol-orders",
            Self::SpotModifyOrder => "/api/v2/spot/trade/modify-order",
            Self::SpotFills => "/api/v2/spot/trade/fills",

            // Common
            Self::TradeRate => "/api/v2/common/trade-rate",
            Self::VipFeeRate => "/api/v2/spot/market/vip-fee-rate",

            // Transfers
            Self::Transfer => "/api/v2/spot/wallet/transfer",
            Self::TransferHistory => "/api/v2/spot/account/transferRecords",

            // Custodial Funds
            Self::DepositAddress => "/api/v2/spot/wallet/deposit-address",
            Self::Withdraw => "/api/v2/spot/wallet/withdrawal",
            Self::DepositHistory => "/api/v2/spot/wallet/deposit-records",
            Self::WithdrawHistory => "/api/v2/spot/wallet/withdrawal-records",

            // Sub Accounts
            Self::SubAccountCreate => "/api/v2/user/create-virtual-subaccount",
            Self::SubAccountList => "/api/v2/user/virtual-subaccount-list",
            Self::SubAccountTransfer => "/api/v2/user/virtual-subaccount-transfer",
            Self::SubAccountAssets => "/api/v2/user/virtual-subaccount-assets",

            // Extended endpoints
            Self::SpotRecentFills => "/api/v2/spot/market/fills",
            Self::SpotHistoryCandles => "/api/v2/spot/market/history-candles",
            Self::FuturesFillHistory => "/api/v2/mix/order/fill-history",
            Self::FuturesOpenInterest => "/api/v2/mix/market/open-interest",
            Self::FuturesFundingRateHistory => "/api/v2/mix/market/history-fund-rate",
            Self::FuturesSymbolPrice => "/api/v2/mix/market/symbol-price",
            Self::SpotBills => "/api/v2/spot/account/bills",

            Self::FuturesMarketFills => "/api/v2/mix/market/fills-history",
            Self::FuturesMarkCandles => "/api/v2/mix/market/history-mark-candles",
            Self::FuturesIndexCandles => "/api/v2/mix/market/history-index-candles",
            Self::FuturesLongShort => "/api/v2/mix/market/long-short",
            Self::FuturesAccountLongShort => "/api/v2/mix/market/account-long-short",
            Self::FuturesTakerBuySell => "/api/v2/mix/market/taker-buy-sell",
        }
    }

    /// Требует ли endpoint авторизации
    pub fn requires_auth(&self) -> bool {
        match self {
            // Public endpoints
            Self::Timestamp
            | Self::SpotPrice
            | Self::SpotOrderbook
            | Self::SpotKlines
            | Self::SpotTicker
            | Self::SpotAllTickers
            | Self::SpotSymbols
            | Self::FuturesPrice
            | Self::FuturesOrderbook
            | Self::FuturesKlines
            | Self::FuturesTicker
            | Self::FuturesAllTickers
            | Self::FuturesContracts
            | Self::FundingRate
            | Self::SpotRecentFills
            | Self::SpotHistoryCandles
            | Self::FuturesOpenInterest
            | Self::FuturesFundingRateHistory
            | Self::FuturesSymbolPrice
            | Self::FuturesMarketFills
            | Self::FuturesMarkCandles
            | Self::FuturesIndexCandles
            | Self::FuturesLongShort
            | Self::FuturesAccountLongShort
            | Self::FuturesTakerBuySell => false,

            // Private endpoints
            _ => true,
        }
    }

    /// HTTP метод для endpoint'а
    pub fn method(&self) -> &'static str {
        match self {
            Self::SpotCreateOrder
            | Self::SpotCancelOrder
            | Self::SpotBatchPlaceOrders
            | Self::SpotBatchCancelOrders
            | Self::SpotCancelBySymbol
            | Self::SpotModifyOrder
            | Self::FuturesCreateOrder
            | Self::FuturesCancelOrder
            | Self::FuturesBatchPlaceOrders
            | Self::FuturesBatchCancelOrders
            | Self::FuturesCancelBySymbol
            | Self::FuturesClosePositions
            | Self::FuturesModifyOrder
            | Self::FuturesPlanOrder
            | Self::FuturesPosTpSl
            | Self::FuturesTwapOrder
            | Self::FuturesSetLeverage
            | Self::FuturesSetMarginMode
            | Self::FuturesSetMargin
            | Self::Transfer
            | Self::Withdraw
            | Self::SubAccountCreate
            | Self::SubAccountTransfer => "POST",

            _ => "GET",
        }
    }
}

// ═══════════════════════════════════════════════════════════════════════════════
// SYMBOL FORMATTING
// ═══════════════════════════════════════════════════════════════════════════════

/// Форматирование символа для Bitget V2 API
///
/// # V2 Symbol Format (SIMPLIFIED)
/// V2 API uses plain symbol format without suffixes.
///
/// # Format
/// - All account types: `{BASE}{QUOTE}`
/// - Examples: `BTCUSDT`, `ETHUSDT`, `BTCUSD`
///
/// # Changes from V1
/// - V1: `BTCUSDT_SPBL` (spot), `BTCUSDT_UMCBL` (futures)
/// - V2: `BTCUSDT` (all types)
///
/// # Examples
/// - Spot: `BTCUSDT`, `ETHBTC`
/// - USDT Futures: `BTCUSDT`, `ETHUSDT`
/// - Coin Futures: `BTCUSD`, `ETHUSD`
pub fn format_symbol(base: &str, quote: &str, _account_type: AccountType) -> String {
    let base = base.to_uppercase();
    let quote = quote.to_uppercase();

    // V2 uses plain format for all account types
    format!("{}{}", base, quote)
}

/// Получить productType для futures API (V2 format)
///
/// # V2 Product Types
/// V2 API uses uppercase format with dashes:
/// - `USDT-FUTURES` - USDT-margined perpetual
/// - `COIN-FUTURES` - Coin-margined perpetual
/// - `USDC-FUTURES` - USDC-margined perpetual
///
/// # Changes from V1
/// - V1: `umcbl`, `dmcbl`, `cmcbl` (lowercase, no dashes)
/// - V2: `USDT-FUTURES`, `COIN-FUTURES`, `USDC-FUTURES` (uppercase with dashes)
pub fn get_product_type(quote: &str) -> &'static str {
    match quote.to_uppercase().as_str() {
        "USDT" => "USDT-FUTURES",
        "USD" => "COIN-FUTURES",
        "USDC" => "USDC-FUTURES",
        _ => "USDT-FUTURES", // Default to USDT-margined
    }
}

/// Маппинг интервала kline для Spot API
///
/// # Spot API Format
/// Parameter: `period` (string)
/// Values: `"1min"`, `"1h"`, `"1day"`, etc.
pub fn map_kline_interval(interval: &str) -> &'static str {
    match interval {
        "1m" => "1min",
        "3m" => "3min",
        "5m" => "5min",
        "15m" => "15min",
        "30m" => "30min",
        "1h" => "1h",
        "2h" => "2h",
        "4h" => "4h",
        "6h" => "6h",
        "12h" => "12h",
        "1d" => "1day",
        "1w" => "1week",
        "1M" => "1M",
        _ => "1h",
    }
}

/// Map long/short ratio `period` param.
///
/// Bitget 2025 breaking change: daily period is `1Dutc` (not `1d` or `1D`).
/// Other granularities follow the same naming as futures granularity.
///
/// Ref: Bitget changelog 2025 — daily `period` renamed from `1d` → `1Dutc`.
pub fn map_ls_period(period: &str) -> &'static str {
    match period {
        "1d" | "1D" | "1Dutc" => "1Dutc",
        "5m" => "5m",
        "15m" => "15m",
        "30m" => "30m",
        "1h" | "1H" => "1H",
        "4h" | "4H" => "4H",
        _ => period_static_fallback(period),
    }
}

/// Helper: static fallback for period values not in the match table.
/// Returns the input unchanged if it is already a known Bitget period string,
/// otherwise defaults to `"1H"`.
fn period_static_fallback(period: &str) -> &'static str {
    // Bitget documented periods for L/S endpoints: 5m 15m 30m 1H 4H 1Dutc
    match period {
        "5m" => "5m",
        "15m" => "15m",
        "30m" => "30m",
        "1H" => "1H",
        "4H" => "4H",
        "1Dutc" => "1Dutc",
        _ => "1H",
    }
}

/// Map kline interval to Futures granularity
///
/// # Futures API Format
/// Parameter: `granularity` (string)
/// Values: `"1m"`, `"1H"`, `"1D"`, etc.
///
/// # Differences from Spot
/// - Futures uses uppercase H, D, W, M
/// - Spot uses lowercase h, day, week
pub fn map_futures_granularity(interval: &str) -> &'static str {
    match interval {
        "1m" => "1m",
        "3m" => "3m",
        "5m" => "5m",
        "15m" => "15m",
        "30m" => "30m",
        "1h" => "1H",
        "2h" => "2H",
        "4h" => "4H",
        "6h" => "6H",
        "12h" => "12H",
        "1d" => "1D",
        "3d" => "3D",
        "1w" => "1W",
        "1M" => "1M",
        _ => "1H", // default 1 hour
    }
}