Contract Symbols

/contract-symbols

/contract-symbols

Example Query:

https://base-hedger82.rasa.capital/contract-symbols

Example Response:

   {
      "price_precision": 1,
      "quantity_precision": 3,
      "name": "BTCUSDT",
      "symbol": "BTC",
      "asset": "USDT",
      "symbol_id": 1,
      "is_valid": true,
      "min_acceptable_quote_value": 120,
      "min_acceptable_portion_lf": "0.003000000000000000",
      "trading_fee": "0.000600000000000000",
      "max_leverage": 60,
      "max_notional_value": 2100000,
      "rfq_allowed": true,
      "hedger_fee_open": "0.0006",
      "hedger_fee_close": "0.0006",
      "max_funding_rate": "200",
      "min_notional_value": "100",
      "max_quantity": "1000",
      "lot_size": "0"
    },
    {
      "price_precision": 3,
      "quantity_precision": 1,
      "name": "FILUSDT",
      "symbol": "FIL",
      "asset": "USDT",
      "symbol_id": 55,
      "is_valid": true,
      "min_acceptable_quote_value": 10,
      "min_acceptable_portion_lf": "0.004000000000000000",
      "trading_fee": "0.000800000000000000",
      "max_leverage": 50,
      "max_notional_value": 1750000,
      "rfq_allowed": true,
      "hedger_fee_open": "0.0006",
      "hedger_fee_close": "0.0006",
      "max_funding_rate": "200",
      "min_notional_value": "5",
      "max_quantity": "10000000",
      "lot_size": "0"
    }, //...

Data Sources

Values are derived from two sources:

1. On-Chain Contract Data: Immutable parameters fetched directly from the blockchain (via getSymbol(symbolId) orgetSymbols(start, size)).

2. Hedger-Defined Parameters: Configurable values set by the market maker/hedger, subject to on-chain constraints.

Contract-Sourced Values

• symbol_id: Unique identifier for the trading pair (e.g., 1 for BTCUSDT). Mapped directly from the contract’s symbolId.

• name: Trading pair name (e.g., BTCUSDT).

• is_valid: Indicates if the symbol is active for trading. Mapped from the contract’s isValid.

• min_acceptable_quote_value: Minimum quote value (e.g., $120) required to open a position. Converted from the contract’s fixed-point value (e.g., 120000000000000000000 → 120).

• min_acceptable_portion_lf: Minimum portion of the liquidity fee (e.g., 0.003). Converted from the contract’s fixed-point value (e.g., 3000000000000000 → 0.003).

• trading_fee: Fee charged per trade (e.g., 0.0006 or 0.06%). Derived from the contract’s tradingFee (e.g., 600000000000000 → 0.0006).

Hedger-Defined Values

• max_leverage: Maximum leverage allowed (e.g., 60x). Must be ≤ the contract’s Leverage (e.g., 60 ≤ 100).

• max_notional_value: Maximum position size (e.g., $2,100,000). Must be ≥ the contract’s minAcceptableQuoteValue (e.g., 2100000 ≥ 120).

• max_quantity: Maximum tradable quantity (e.g., 1000 BTC). No on-chain constraints.

• max_funding_rate: Upper limit for funding rate (e.g., 200 ). Set by the hedger.

• min_notional_value: Minimum position size (e.g., $100). Configured by the hedger.

• hedger_fee_open/hedger_fee_close: Additional fees charged by the hedger (e.g., 0.0006).

• rfq_allowed: Whether Request for Quote (RFQ) is enabled for the symbol.

Derived Values

• symbol/asset: Base and quote assets (e.g., BTC and USDT). Parsed from the name field (e.g., BTCUSDT → symbol: BTC, asset: USDT).

• price_precision: Number of decimal places for price (e.g., 1 → $100.1). Determined by the hedger based on market conventions.

• quantity_precision: Number of decimal places for quantity (e.g., 3 → 0.001 BTC). Derived from min_acceptable_portion_lf (e.g., 0.003 implies 3 decimals).

• lot_size: Always 0 (no minimum lot size enforced).