Documentación de la API

Inicio rápido

1. Crea una cuenta y abre Mis claves en tu panel.
2. Crea una clave de prueba. Indica la dirección IPv4 o IPv6 pública del servidor que se conectará a los datos: la clave solo funciona desde esa dirección.
3. Copia la clave completa con el botón Copiar y guárdala en tu servidor, por ejemplo en una variable de entorno. Las claves de prueba empiezan por qtc_ y las de producción por prd_.
4. Desde ese servidor, abre una conexión WebSocket con el endpoint indicado abajo y envía el mensaje de autenticación.
5. Recibe cada segundo un tick por cada par disponible. Vuelve a conectarte automáticamente si se pierde la conexión.

Claves API

Crea una clave de producción en tu panel y abre un ticket de soporte para gestionar el pago. La nueva clave de producción permanece inactiva hasta que nuestro equipo la activa y establece su fecha de vencimiento. Puedes crear varias claves de producción, por ejemplo una por servidor.

Cada clave está vinculada a la dirección IP de un servidor. Las conexiones desde cualquier otra dirección se rechazan. Para cambiar la dirección o renovar una clave, contacta con soporte desde tu panel.

Mantén la clave en secreto. Úsala solo en tu servidor: nunca la incluyas en código del navegador, aplicaciones móviles ni repositorios públicos. Si la clave se filtra, contacta con soporte para sustituirla.

Conexión

Endpoint wss://wss.quotc.net

Utiliza cualquier cliente WebSocket para tu lenguaje. En los 10 segundos siguientes a abrir la conexión, envía el mensaje de autenticación con tu clave:

{"type": "auth", "token": "qtc_YOUR_KEY", "protocol": 2}

Indica protocol igual a 2 para recibir los mensajes de servicio (auth_ok, subscribed). Los clientes que lo omiten reciben solo ticks y mensajes pong.

Tras una autenticación correcta, el servidor responde con auth_ok. Incluye los pares disponibles para la clave y la fecha de vencimiento de la clave en segundos Unix (UTC):

{
  "type": "auth_ok",
  "expiresAt": 1795683600,
  "symbols": [
    { "symbol": "EURUSD", "label": "EUR/USD", "digits": 5 }
  ]
}

Cada clave admite hasta 10 conexiones simultáneas, por lo que varios servicios del mismo servidor pueden compartirla.

Cierre y reconexión

Utiliza el código de cierre para decidir si debes volver a conectarte:

Las conexiones abiertas se vuelven a comprobar cada minuto. Si una clave se desactiva, vence, se elimina o se sustituye, sus conexiones se cierran con el código 1008.

Cotizaciones

Cada segundo el servidor envía un mensaje por cada par disponible para tu clave:

{
  "symbol": "EURUSD",
  "value": 1.11609,
  "open": 1.11608,
  "high": 1.11609,
  "low": 1.11608,
  "volume": 2,
  "ts": 1793091620000
}

Los precios se redondean al número de decimales indicado para cada par en la lista de abajo.

Solicitudes

Tras la autenticación, tu cliente puede enviar los siguientes mensajes. Las respuestas se muestran después de la flecha.

Ping

Mantiene la conexión activa a través de proxies. Envíalo cada 30 segundos; el servidor responde con pong y el mismo timestamp.

{"type": "ping", "timestamp": 1793091620000}
→ {"type": "pong", "timestamp": 1793091620000}

Seleccionar pares

Por defecto recibes todos los pares disponibles para la clave. Envía subscribe para limitar el flujo a los pares indicados; los pares no disponibles para la clave se ignoran. Puedes enviarlo de nuevo en cualquier momento para cambiar la lista.

{"type": "subscribe", "symbols": ["EURUSD", "USDJPY"]}
→ {"type": "subscribed", "symbols": ["EURUSD", "USDJPY"]}

Ejemplos de código

Clientes completos que se autentican, muestran los ticks y se reconectan tras errores de red. Antes de ejecutarlos, guarda tu clave en la variable de entorno QUOTC_API_KEY del servidor cuya IP está vinculada a la clave.

// npm install ws
const WebSocket = require('ws');

const URL = 'wss://wss.quotc.net';
const API_KEY = process.env.QUOTC_API_KEY; // keep the key out of source code

function connect() {
  const ws = new WebSocket(URL);
  let ping;

  ws.on('open', () => {
    ws.send(JSON.stringify({ type: 'auth', token: API_KEY, protocol: 2 }));
    ping = setInterval(() => {
      ws.send(JSON.stringify({ type: 'ping', timestamp: Date.now() }));
    }, 30000);
  });

  ws.on('message', (raw) => {
    const msg = JSON.parse(raw);
    if (msg.type === 'auth_ok') {
      console.log('Authorized. Pairs:', msg.symbols.map((s) => s.symbol).join(', '));
    } else if (msg.symbol) {
      console.log(msg.symbol, msg.value, new Date(msg.ts).toISOString());
    }
  });

  ws.on('close', (code, reason) => {
    clearInterval(ping);
    if (code === 1008) {
      console.error('Access denied:', reason.toString(), '- check the key and server IP');
      return; // do not retry with the same key
    }
    setTimeout(connect, 3000); // network error or service restart
  });

  ws.on('error', (err) => console.error(err.message));
}

connect();

# pip install websockets
import asyncio
import json
import os

import websockets

URL = "wss://wss.quotc.net"
API_KEY = os.environ["QUOTC_API_KEY"]  # keep the key out of source code


async def main():
    while True:
        try:
            async with websockets.connect(URL) as ws:
                await ws.send(json.dumps({"type": "auth", "token": API_KEY, "protocol": 2}))
                async for raw in ws:
                    msg = json.loads(raw)
                    if msg.get("type") == "auth_ok":
                        print("Authorized. Pairs:", [s["symbol"] for s in msg["symbols"]])
                    elif "symbol" in msg:
                        print(msg["symbol"], msg["value"], msg["ts"])
        except websockets.ConnectionClosed as e:
            if e.rcvd is not None and e.rcvd.code == 1008:
                print("Access denied:", e.rcvd.reason, "- check the key and server IP")
                return  # do not retry with the same key
        except OSError as e:
            print("Connection error:", e)
        await asyncio.sleep(3)  # network error or service restart


asyncio.run(main())

Conéctate desde tu servidor, no desde el navegador: la clave está vinculada a la IP del servidor y debe mantenerse en secreto. Para mostrar cotizaciones en tu sitio web, reenvíalas desde tu servidor a tus visitantes.

Pares disponibles

Una clave de producción cubre los 58 pares. La clave de prueba cubre los pares marcados en la última columna.

Sobre los datos

Las cotizaciones de QUOTC son precios OTC generados de forma independiente. Siguen el nivel general del mercado de divisas, pero no son precios del mercado forex al contado ni los reproducen tick a tick. Las cotizaciones están disponibles las 24 horas, los 7 días de la semana, incluidos fines de semana y festivos.

¿Tienes preguntas sobre la integración? Contacta con nosotros o abre un ticket en tu panel.