Symbols

Retrieve specifications for all available trading symbols or look up a single symbol. Always check symbol specs before placing trades to ensure you use valid volume sizes and understand the contract details.

List All Symbols

GET /v1/symbols

Returns the full list of available symbols with their specifications.

Weight: 2

Example Request

curl -X GET https://interface.xbtfx.com/v1/symbols \
  -H "Authorization: Bearer your_api_key_here"

Get Single Symbol

GET /v1/symbols/:symbol

Returns the specification for a single symbol.

Weight: 1

Example Request

curl -X GET https://interface.xbtfx.com/v1/symbols/EURUSD \
  -H "Authorization: Bearer your_api_key_here"

List Response

{
  "symbols": [
    {
      "name": "EURUSD",
      "digits": 5,
      "contract_size": 100000.0,
      "point": 0.00001,
      "trade_mode": "Full",
      "spread": 0,
      "swap_long": -6.3,
      "swap_short": 0.95,
      "bid": 1.08230,
      "ask": 1.08240
    }
  ],
  "count": 422
}

Single Symbol Response

{
  "symbol": "NDXUSD",
  "description": "Nasdaq 100 vs USD",
  "path": "CFD\\Indices\\NDXUSD",
  "currency_base": "USD",
  "currency_profit": "USD",
  "currency_margin": "USD",
  "digits": 2,
  "point": 0.01,
  "contract_size": 1.0,
  "trade_mode": "Full",
  "tradeable": true,
  "calc_mode": 0,
  "spread": 100,
  "stops_level": 0,
  "volume_min": 0.10,
  "volume_max": 50.00,
  "volume_step": 0.10,
  "tick_value": 0.01,
  "tick_size": 0.01,
  "swap_mode": 1,
  "swap_long": -4.50,
  "swap_short": -3.20,
  "swap_3day": 3,
  "margin_initial": 0.0,
  "margin_maintenance": 0.0,
  "margin_long": 5.0,
  "margin_short": 5.0,
  "margin_hedged": 5.0,
  "bid": 21543.50,
  "ask": 21544.50,
  "sessions": {
    "trade": [
      { "day": "monday", "open": "01:00", "close": "23:55" },
      { "day": "tuesday", "open": "01:00", "close": "23:55" },
      { "day": "wednesday", "open": "01:00", "close": "23:55" },
      { "day": "thursday", "open": "01:00", "close": "23:55" },
      { "day": "friday", "open": "01:00", "close": "23:55" }
    ],
    "quote": [
      { "day": "monday", "open": "01:00", "close": "23:55" }
    ]
  }
}

Response Fields

Field	Type	Description
`symbol`	string	Symbol name
`description`	string	Human-readable description
`path`	string	Symbol path in the broker’s symbol tree
`currency_base`	string	Base currency
`currency_profit`	string	Profit currency
`currency_margin`	string	Margin currency
`digits`	integer	Number of decimal places in price
`point`	number	Smallest price increment
`contract_size`	number	Contract size per 1.0 lot
`trade_mode`	string	Trading mode (e.g., `Full`, `disabled`)
`tradeable`	boolean	Whether the symbol is currently tradeable
`calc_mode`	integer	Profit calculation mode (0 = Forex, 1 = CFD, 2 = Futures, etc.)
`spread`	integer	Current spread in points
`stops_level`	integer	Minimum distance for SL/TP in points
`volume_min`	number	Minimum trade volume in lots
`volume_max`	number	Maximum trade volume in lots
`volume_step`	number	Volume step increment
`tick_value`	number	Value of one tick in the profit currency
`tick_size`	number	Minimum price change
`swap_mode`	integer	Swap calculation mode: `0` = disabled, `1` = points, `2` = currency
`swap_long`	number	Swap value for long positions
`swap_short`	number	Swap value for short positions
`swap_3day`	integer	Day of week for triple swap: `0` = Sunday .. `6` = Saturday (typically `3` = Wednesday)
`margin_initial`	number	Initial margin requirement (0.0 means calculated automatically)
`margin_maintenance`	number	Maintenance margin requirement (0.0 means calculated automatically)
`margin_long`	number	Long margin rate (percentage)
`margin_short`	number	Short margin rate (percentage)
`margin_hedged`	number	Hedged margin rate (percentage)
`bid`	number	Current bid price (Continuum price feed)
`ask`	number	Current ask price (Continuum price feed)
`sessions`	object	Trading and quote session schedules
`sessions.trade`	array	Array of trading sessions with `day`, `open`, and `close` times
`sessions.quote`	array	Array of quote sessions with `day`, `open`, and `close` times