Bourse.Market (bourse v0.1.0)

Copy Markdown View Source

Unified market/instrument metadata.

Describes a trading pair and its properties — spot, derivatives, precision, limits, and fee structure.

Fields

  • id - Exchange-native market ID (e.g., "BTCUSDT")
  • symbol - Unified symbol (e.g., "BTC/USDT")
  • base, quote - Base and quote currency codes
  • base_id, quote_id - Exchange-native currency IDs
  • type - Market type: "spot", "swap", "future", "option"
  • sub_type - "linear" or "inverse" for derivatives
  • spot, margin, swap, future, option, contract - Type flags
  • active - Whether the market is currently trading
  • settle, settle_id - Settlement currency
  • contract_size - Contract size for derivatives
  • quantity_unit - Canonical option quantity unit ("base")
  • native_quantity_unit - Venue option quantity unit ("base" or "contracts")
  • native_quantity_field - Venue option order field carrying the quantity
  • native_amount_step - Venue-native quantity increment before conversion
  • linear, inverse - Settlement direction flags
  • expiry, expiry_datetime - Futures/options expiration
  • strike - Options strike price
  • option_type - "call" or "put"
  • taker, maker - Fee rates as decimals
  • percentage - Whether fees are charged as a percentage
  • tier_based - Whether fees use a tiered schedule
  • precision_mode - Authored precision interpretation mode
  • precision - Price/amount/cost precision rules
  • limits - Min/max for price, amount, cost, leverage
  • created - Market listing timestamp in milliseconds
  • asset_index - Venue signing index for L1 actions (Hyperliquid: meta/spotMeta universe position with spot/HIP-3 offsets). Explicit — not overloaded onto id/base_id (carve C-T339).
  • info - Raw exchange response

Summary

Types

t()

Functions

schema()

JSON Schema for the Market unified type.

Types

t()

@type t() :: %Bourse.Market{
  active: boolean() | nil,
  asset_index: integer() | nil,
  base: String.t() | nil,
  base_id: String.t() | nil,
  contract: boolean() | nil,
  contract_size: number() | nil,
  created: integer() | nil,
  expiry: integer() | nil,
  expiry_datetime: String.t() | nil,
  future: boolean() | nil,
  id: String.t() | nil,
  info: map() | nil,
  inverse: boolean() | nil,
  limits: map() | nil,
  linear: boolean() | nil,
  maker: number() | nil,
  margin: boolean() | nil,
  native_amount_step: number() | nil,
  native_quantity_field: String.t() | nil,
  native_quantity_unit: String.t() | nil,
  option: boolean() | nil,
  option_type: String.t() | nil,
  percentage: boolean() | nil,
  precision: map() | nil,
  precision_mode: String.t() | nil,
  quantity_unit: String.t() | nil,
  quote: String.t() | nil,
  quote_id: String.t() | nil,
  settle: String.t() | nil,
  settle_id: String.t() | nil,
  spot: boolean() | nil,
  strike: number() | nil,
  sub_type: String.t() | nil,
  swap: boolean() | nil,
  symbol: String.t() | nil,
  taker: number() | nil,
  tier_based: boolean() | nil,
  type: String.t() | nil
}

Functions

schema()

@spec schema() :: map()

JSON Schema for the Market unified type.