API de trading crypto en Volity: acceso REST y WebSocket para sistemas a medida

La API de trading crypto de Volity da a los desarrolladores acceso programático a datos de mercado, gestión de órdenes y manejo de posiciones. Los endpoints REST gestionan el estado de la cuenta, la entrada de órdenes y los datos históricos. Los streams WebSocket entregan precios en tiempo real y eventos de trade. Entorno sandbox, soporte de Expert Advisors MQL y límites de tasa VIP completan la oferta.

Lo que te da la API de trading crypto

Tres patrones de integración, según el grado de personalización de tu sistema:

1. Expert Advisors MQL (EAs). El camino más sencillo. Escribe o compra un EA en MQL4 o MQL5, déjalo caer en Volity MT, y el EA ejecuta en tu nombre usando el mismo motor de ejecución que el trading manual. Los EAs corren sobre la infraestructura de Volity con la misma tasa del 99,6 % de ejecuciones por debajo de 1 segundo.

2. API REST. Integración servidor a servidor. Consulta saldos de cuenta, posiciones abiertas, coloca órdenes, recupera el historial de operaciones. HTTP/JSON estándar. Autenticación mediante clave API emitida en el portal de la cuenta. Adecuada para estrategias algorítmicas construidas en Python, Node.js, Go o cualquier lenguaje que maneje HTTP.

3. Streams WebSocket. Datos de mercado y eventos de cuenta en tiempo real. Suscríbete a streams de ticks de precio de cualquier instrumento, escucha ejecuciones de órdenes, actualizaciones de posición, cambios de saldo. Entrega push de baja latencia. Combinado con REST para cobertura total del sistema.

Categorías de endpoints

Endpoints de cuenta (REST): GET /account, saldo, equity, nivel de margen, exposición. GET /positions, posiciones abiertas con P&L y requisito de margen. GET /orders, órdenes abiertas y pendientes. GET /history, operaciones y órdenes históricas.

Endpoints de datos de mercado (REST): GET /instruments, lista completa de instrumentos con especificaciones. GET /quotes/{symbol}, bid/ask actuales. GET /candles/{symbol}, historial OHLCV en cualquier marco temporal.

Endpoints de trading (REST): POST /orders, coloca órdenes a mercado, limitadas, stop u OCO. PUT /orders/{id}, modifica una orden abierta. DELETE /orders/{id}, cancela una orden. POST /positions/{id}/close, cierra una posición concreta.

Canales WebSocket: quotes:{symbol}, streaming de bid/ask en tiempo real. trades:{symbol}, ticks de operaciones públicas. account, actualizaciones del estado de tu cuenta. positions, actualizaciones de tus posiciones. orders, actualizaciones de tus órdenes.

Autenticación

Las claves API se emiten desde el portal de la cuenta en Ajustes → Acceso API. Cada clave tiene:

• Permisos: solo lectura, trading habilitado o acceso completo incluyendo retiros
• Lista de IPs permitidas: restringe la clave a IPs de origen concretas
• Tramo de límite de tasa: Standard (60 req/min) o VIP (600 req/min)
• Conmutador sandbox: prueba con capital de demo antes de pasar a live

Las claves se pueden revocar en cualquier momento. Buena práctica: claves separadas por entorno (una para backtesting, una para live, una para monitoreo).

Ejemplos de código

Python REST: colocar una orden a mercado

«`python import requests import os

headers = { «Authorization»: f»Bearer {os.environ[‘VOLITY_API_KEY’]}», «Content-Type»: «application/json» } order = { «symbol»: «BTCUSD», «side»: «buy», «type»: «market», «size»: 0.01, «stop_loss»: 65000, «take_profit»: 75000 } r = requests.post(«https://api.volity.io/v1/orders», json=order, headers=headers) print(r.json()) «`

Node.js WebSocket: suscribirse a ticks de BTC

«`javascript import WebSocket from ‘ws’;

const ws = new WebSocket(‘wss://stream.volity.io/v1?api_key=’ + process.env.VOLITY_API_KEY);

ws.on(‘open’, () => { ws.send(JSON.stringify({ subscribe: [‘quotes:BTCUSD’, ‘quotes:ETHUSD’] })); });

ws.on(‘message’, (data) => { const tick = JSON.parse(data); console.log(${tick.symbol}: bid ${tick.bid} ask ${tick.ask}); }); «`

Límites de tasa

El tramo VIP se desbloquea a partir de un saldo de cuenta de 50.000 €. El margen de maniobra en los límites de tasa es una de las razones prácticas por las que las estrategias de alta frecuencia pasan a VIP pronto.

Entorno sandbox

Cada clave API puede alternar entre sandbox (capital de demo) y live (capital real). Sandbox es idéntico a live en todos los aspectos excepto en los fondos; las órdenes se ejecutan contra saldo virtual. Úsalo para:

• Probar nuevas estrategias antes de desplegar en live
• Validar el manejo de errores y la lógica de reconexión
• Incorporar nuevos desarrolladores sin exponer claves live
• Ejecutar suites de tests automatizados en pipelines CI/CD

El cambio es un único parámetro API o una URL base distinta (sandbox.api.volity.io).

Casos de uso habituales de la API de trading crypto

• Trading algorítmico. Estrategias a medida en Python o C++ que el framework EA MQL no puede expresar
• Cuadros de mando de portafolio. Agregar posiciones de Volity más otras cuentas en una sola vista
• Capas de monitorización de riesgo. Comprobar de forma continua drawdown, concentración de exposición y uso del apalancamiento; alertar al sobrepasar un umbral
• Infraestructura de backtesting. Extraer datos históricos, reproducirlos contra tu estrategia con spreads y slippage realistas
• Herramientas de reporting y cumplimiento. Exportar P&L diario, generar reportes por operación para fiscalidad o auditoría
• Sistemas de copy-trading. Replicar operaciones de una cuenta maestra a cuentas seguidoras (sujeto a requisitos regulatorios)

Latencia y fiabilidad

La API de Volity corre desde centros de datos europeos con presencia edge global. Latencias medianas típicas:

• Petición REST desde la UE: 30 a 80 ms
• Petición REST desde la costa este de EE. UU.: 90 a 130 ms
• Entrega de tick WebSocket: menos de 50 ms desde la actualización de la cotización al cliente
• SLA de disponibilidad: 99,9 % en Standard, 99,99 % en VIP

Para estrategias sensibles a la latencia, las cuentas del tramo VIP pueden solicitar cross-connects dedicados al núcleo de trading.

Buenas prácticas de seguridad

• Nunca subas claves API a git. Usa variables de entorno o un gestor de secretos
• Restringe por IP en las claves de producción
• Usa claves de solo lectura para cuadros de mando y monitorización
• Rota las claves trimestralmente como parte de la higiene estándar
• Activa el 2FA en la propia cuenta, no solo en la clave
• Registra todo el uso de claves en el lado del servidor para detectar accesos anómalos

Fuentes

• Documentación MetaQuotes MQL5
• Especificación OAuth 2.0

Preguntas frecuentes