Symboles actifs

DonnéesPas d'authentification

Obtenez la liste des symboles actifs, les marchés sous-jacents sur lesquels vous pouvez trader des contrats. Les champs de réponse sont renommés, les champs spot et display sont supprimés, les paramètres de filtrage sont supprimés et les valeurs de contract_type ont changé.

7 changements majeurs

symbol est renommé en underlying_symbol et d’autres champs sont renommés, les champs d’affichage, spot et de métadonnées sont supprimés, les paramètres de filtrage sont supprimés, et le filtre contract_type accepte des valeurs différentes.

Comparaison rapide

Aspect	Legacy API	New API	Action
Point de terminaison	active_symbols	active_symbols	Aucun
Authentification requise	Non	Non	Aucun
Paramètres de requête	9 paramètres	4 paramètres	Retirer les paramètres obsolètes
Champs de symbole	symbol, symbol_type, display_name, pip	underlying_symbol, underlying_symbol_type, underlying_symbol_name, pip_size	Renommez dans votre code
Champs spot	Renvoyé	Supprimé	Utilisez ticks pour les prix spot
`contract_type` valeurs	Inclut les spreads et les lookbacks	Ajoute HIGHER et LOWER	Mettez à jour vos filtres

Modifications majeures

1. Champs de réponse renommés

Quatre champs de chaque symbole sont renommés :

symbol → underlying_symbol
symbol_type → underlying_symbol_type
display_name → underlying_symbol_name
pip → pip_size

Modification requise : Lisez les nouveaux noms de champs. Le nom d’affichage du symbole est toujours renvoyé sous le nom underlying_symbol_name.

2. Champs de nom d'affichage traduits supprimés

market_display_name, subgroup_display_name et submarket_display_name ne sont plus renvoyés.

Modification requise : Créez les noms d’affichage à partir de market, subgroup et submarket à la place.

3. Champs spot supprimés

spot, spot_age, spot_percentage_change et spot_time ne sont plus renvoyés.

Modification requise : Utilisez l’appel ticks pour obtenir les prix spot en temps réel.

4. Landing Company, type de produit et paramètres `loginid` supprimés

La requête n’accepte plus landing_company, landing_company_short, product_type ni loginid.

Modification requise : Supprimez ces paramètres de vos requêtes active_symbols .

5. `barrier_category` supprimé

La requête n’accepte plus barrier_category, vous ne pouvez donc plus filtrer les symboles par catégorie de barrière.

Modification requise : Supprimez barrier_category et filtrez la liste des symboles dans votre code, ou filtrez par contract_type.

6. Champs de métadonnées supprimés

allow_forward_starting, close_only, delay_amount, display_order, exchange_name, intraday_interval_minutes et quoted_currency_symbol ne sont plus renvoyés.

Modification requise : Cessez de lire ces champs.

7. `contract_type` valeurs modifiées

Le filtre contract_type n’accepte plus CALLSPREAD, PUTSPREAD, LBFLOATCALL, LBFLOATPUT ni LBHIGHLOW, et ajoute HIGHER et LOWER.

Modification requise : Supprimez de contract_typeles valeurs que la nouvelle API n’accepte plus.

Structure de la demande

Legacy APIexemple de demande

{
  "active_symbols": "brief",
  "contract_type": [
    "CALL",
    "CALLSPREAD"
  ],
  "landing_company": "svg",
  "req_id": 1
}

New APIexemple de demande

{
  "active_symbols": "brief",
  "contract_type": [
    "CALL",
    "HIGHER"
  ],
  "req_id": 1
}

Structure de réponse

Legacy APIexemple de réponse

{
  "active_symbols": [
    {
      "display_name": "Volatility 100 Index",
      "display_order": 1,
      "exchange_is_open": 1,
      "is_trading_suspended": 0,
      "market": "synthetic_index",
      "market_display_name": "Derived",
      "pip": 0.01,
      "subgroup": "synthetics",
      "subgroup_display_name": "Synthetics",
      "submarket": "random_index",
      "submarket_display_name": "Continuous Indices",
      "symbol": "R_100",
      "symbol_type": "stockindex"
    }
  ],
  "echo_req": {
    "active_symbols": "brief",
    "contract_type": [
      "CALL",
      "CALLSPREAD"
    ],
    "landing_company": "svg",
    "req_id": 1
  },
  "msg_type": "active_symbols",
  "req_id": 1
}

New APIexemple de réponse

{
  "active_symbols": [
    {
      "exchange_is_open": 1,
      "is_trading_suspended": 0,
      "market": "synthetic_index",
      "pip_size": 0.01,
      "subgroup": "synthetics",
      "submarket": "random_index",
      "trade_count": 1250,
      "underlying_symbol": "R_100",
      "underlying_symbol_name": "Volatility 100 Index",
      "underlying_symbol_type": "stockindex"
    }
  ],
  "echo_req": {
    "active_symbols": "brief",
    "contract_type": [
      "CALL",
      "HIGHER"
    ],
    "req_id": 1
  },
  "msg_type": "active_symbols",
  "req_id": 1
}

Exemples de code

function getActiveSymbols() {
  ws.send(JSON.stringify({ active_symbols: "brief", landing_company: "svg" }));

  ws.onmessage = (event) => {
    const response = JSON.parse(event.data);
    if (response.msg_type !== "active_symbols" || !response.active_symbols) return;

    response.active_symbols.forEach((symbol) => {
      console.log(symbol.symbol, symbol.display_name, symbol.market_display_name, symbol.pip);
    });
  };
}

Points de terminaison de données Contrats pour

D'autres questions ? Nous contacter