Contratos para
DatosSin autenticaciónObtenga los contratos disponibles para un símbolo. Se eliminaron los parámetros de solicitud, los datos de mercado, los campos de visualización y los campos de Snowball, y display_number_of_contracts puede ser null.
6 cambios importantes
display_number_of_contracts puede ser null.Comparación rápida
Cambios importantes
1. Parámetros de solicitud eliminados
La solicitud ya no acepta currency, landing_company, landing_company_short, product_type ni loginid.
Cambio obligatorio: Elimine estos parámetros de sus solicitudes de contracts_for .
2. Se eliminaron los campos de datos de mercado
El objeto contracts_for ya no devuelve spot, open, close, feed_license ni non_available.
Cambio obligatorio: Use ticks para los precios spot y trading_times para los horarios de mercado.
3. Se eliminaron los campos de visualización
Los contratos en available ya no devuelven contract_display ni contract_category_display.
Cambio obligatorio: Cree nombres de visualización a partir de contract_type y contract_category en su lugar.
4. Se eliminaron los metadatos del contrato
Los contratos en available ya no devuelven barrier_category, exchange_name, start_type, forward_starting_options ni trading_period. La API Legacy siempre devolvía barrier_category, contract_category_display, exchange_name y start_type.
Cambio obligatorio: Deje de leer estos campos.
5. Opciones de Snowball eliminadas
Los contratos en available ya no devuelven duration_choices ni trade_risk_profile_choices, que describían los contratos Snowball.
Cambio obligatorio: Deje de leer estos campos.
6. display_number_of_contracts puede ser null
display_number_of_contracts siempre fue un número en la Legacy API. En la New API puede ser null.
Cambio obligatorio: Gestione un valor null antes de mostrarlo o realizar cálculos con él.
Estructura de solicitud
{
"contracts_for": "R_100",
"currency": "USD",
"landing_company": "svg",
"product_type": "basic",
"req_id": 1
}{
"contracts_for": "R_100",
"req_id": 1
}Estructura de respuesta
{
"contracts_for": {
"available": [
{
"barriers": 0,
"contract_category": "callput",
"contract_type": "CALL",
"expiry_type": "intraday",
"market": "synthetic_index",
"max_contract_duration": "1d",
"min_contract_duration": "15s",
"sentiment": "up",
"submarket": "random_index",
"underlying_symbol": "R_100",
"barrier_category": "euro_atm",
"contract_category_display": "Up/Down",
"contract_display": "Higher",
"exchange_name": "RANDOM",
"start_type": "spot"
}
],
"close": 1760054399,
"feed_license": "realtime",
"hit_count": 1,
"open": 1759968000,
"spot": 1234.56
},
"echo_req": {
"contracts_for": "R_100",
"currency": "USD",
"landing_company": "svg",
"product_type": "basic",
"req_id": 1
},
"msg_type": "contracts_for",
"req_id": 1
}{
"contracts_for": {
"available": [
{
"barriers": 0,
"contract_category": "callput",
"contract_type": "CALL",
"expiry_type": "intraday",
"market": "synthetic_index",
"max_contract_duration": "1d",
"min_contract_duration": "15s",
"sentiment": "up",
"submarket": "random_index",
"underlying_symbol": "R_100"
}
],
"hit_count": 1
},
"echo_req": {
"contracts_for": "R_100",
"req_id": 1
},
"msg_type": "contracts_for",
"req_id": 1
}Ejemplos de código
function getContracts(symbol) {
ws.send(JSON.stringify({ contracts_for: symbol, currency: "USD", landing_company: "svg" }));
ws.onmessage = (event) => {
const response = JSON.parse(event.data);
if (response.msg_type !== "contracts_for" || !response.contracts_for) return;
console.log("Spot:", response.contracts_for.spot);
response.contracts_for.available.forEach((contract) => {
console.log(contract.contract_display, contract.exchange_name, contract.display_number_of_contracts);
});
};
}¿Alguna otra pregunta? Póngase en contacto