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"

Response

{
  "symbol": "EURUSD",
  "description": "Euro vs US Dollar",
  "currency_base": "EUR",
  "currency_profit": "USD",
  "currency_margin": "EUR",
  "digits": 5,
  "point": 0.00001,
  "contract_size": 100000,
  "trade_mode": "full",
  "tradeable": true,
  "volume_min": 0.01,
  "volume_max": 100.0,
  "volume_step": 0.01,
  "stops_level": 0,
  "freeze_level": 0,
  "spread": 12,
  "bid": 1.08745,
  "ask": 1.08757
}

Response Fields

Field	Type	Description
`symbol`	string	Symbol name
`description`	string	Human-readable description
`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
`volume_min`	number	Minimum trade volume in lots
`volume_max`	number	Maximum trade volume in lots
`volume_step`	number	Volume step increment
`stops_level`	integer	Minimum distance for SL/TP in points
`freeze_level`	integer	Freeze distance in points (orders within this range cannot be modified)
`spread`	integer	Current spread in points
`bid`	number	Current bid price
`ask`	number	Current ask price