Documentación

Símbolos activos

DatosSin autenticación

Obtenga la lista de símbolos activos, los Mercados subyacentes en los que puede hacer trading con contratos. Se cambiaron los nombres de los campos de respuesta, se eliminaron los campos spot y display, se eliminaron los parámetros de filtrado y los valores de contract_type cambiaron.

Comparación rápida

AspectoLegacy APINew APIAcción
Endpointactive_symbolsactive_symbolsNinguno
Requiere autenticaciónNoNoNinguno
Parámetros de solicitud9 parámetros4 parámetrosEliminar parámetros innecesarios
Campos de símbolosymbol, symbol_type, display_name, pipunderlying_symbol, underlying_symbol_type, underlying_symbol_name, pip_sizeCambie el nombre en su código
Campos spotDevueltoEliminadoUse ticks para los precios spot
contract_type valoresIncluye spreads y lookbacksAgrega HIGHER y LOWERActualice sus filtros

Cambios importantes

1. Campos de respuesta renombrados

Se cambiaron los nombres de cuatro campos de cada símbolo:

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

Cambio obligatorio: Lea los nuevos nombres de los campos. El nombre mostrado del símbolo aún se devuelve como underlying_symbol_name.

2. Campos de nombre de visualización traducidos eliminados

market_display_name, subgroup_display_name y submarket_display_name ya no se devuelven.

Cambio obligatorio: Cree nombres de visualización a partir de market, subgroup y submarket en su lugar.

3. Se eliminaron los campos spot

spot, spot_age, spot_percentage_change y spot_time ya no se devuelven.

Cambio obligatorio: Use la llamada ticks para obtener precios spot en tiempo real.

4. Empresa contratante, tipo de producto y parámetros loginid eliminados

La solicitud ya no acepta landing_company, landing_company_short, product_type ni loginid.

Cambio obligatorio: Elimine estos parámetros de sus solicitudes de active_symbols .

5. barrier_category eliminado

La solicitud ya no acepta barrier_category, por lo que ya no puede filtrar símbolos por categoría de barrera.

Cambio obligatorio: Elimine barrier_category y filtre la lista de símbolos en su código, o filtre por contract_type.

6. Se eliminaron los campos de metadatos

allow_forward_starting, close_only, delay_amount, display_order, exchange_name, intraday_interval_minutes y quoted_currency_symbol ya no se devuelven.

Cambio obligatorio: Deje de leer estos campos.

7. contract_type valores modificados

El filtro contract_type ya no acepta CALLSPREAD, PUTSPREAD, LBFLOATCALL, LBFLOATPUT ni LBHIGHLOW, y añade HIGHER y LOWER.

Cambio obligatorio: Elimine de contract_typelos valores que la nueva API ya no acepta.

Estructura de solicitud

Legacy APIejemplo de solicitud
{
  "active_symbols": "brief",
  "contract_type": [
    "CALL",
    "CALLSPREAD"
  ],
  "landing_company": "svg",
  "req_id": 1
}
New APIejemplo de solicitud
{
  "active_symbols": "brief",
  "contract_type": [
    "CALL",
    "HIGHER"
  ],
  "req_id": 1
}

Estructura de respuesta

Legacy APIejemplo de respuesta
{
  "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 APIejemplo de respuesta
{
  "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
}

Ejemplos de código

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);
    });
  };
}
Click to open live chat support. Get instant help from our support team.