Clarity API para Desarrolladores
Desarrolla tus propias integraciones, automatiza la inserción de operaciones o conecta terminales personalizadas directamente a la API REST robusta de Clarity.
Introducción
La API de Clarity permite a desarrolladores conectar sistemas algorítmicos (EAs propios, scripts en Python, bots de Node.js o conectores propietarios) para sincronizar trades e interactuar con la gestión de riesgo en la nube.
Toda la comunicación se realiza bajo formato JSON a través del protocolo HTTPS estándar.
Autenticación
Para interactuar con los endpoints de la API, necesitas proveer tu token único de desarrollador en la cabecera HTTP X-Clarity-Token. Puedes generar y copiar este token desde el panel de configuración de tu cuenta Clarity.
X-Clarity-Token: tu_api_token_secreto_aqui
Endpoint: Registro de Trades
Si has desarrollado tu propio conector o robot y quieres empujar un trade cerrado o abierto al diario de Clarity:
Request
POST /api/trades_ea
Content-Type: application/json
X-Clarity-Token: tu_api_token_secreto_aqui
{
"ea_id": "mi_robot_1",
"ticket": 1234567,
"activo": "EURUSD",
"tipo": "BUY",
"lotes": 1.5,
"precio_entrada": 1.08210,
"precio_salida": 1.08540,
"sl": 1.08050,
"tp": 1.08700,
"resultado": 495.00,
"comentario": "Operativa DQM en zona H1",
"magico": 99221
}
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"ok": true,
"status": "synchronized",
"trade_id": "1234567_mi_robot_1"
}
Endpoint: Control de Riesgo (Risk Check)
Consulta en tiempo real la salud de la cuenta del trader y si la consola de Clarity ha bloqueado la operativa por alcanzar límites de drawdown institucional o diario:
Request
GET /api/risk_config X-Clarity-Token: tu_api_token_secreto_aqui
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"ok": true,
"drawdown_diario_max": 2.00,
"bloqueado_temporalmente": false,
"current_drawdown_diario": -0.45,
"limites_activos": true
}
Integraciones a Medida
Si eres gestor de una academia o una comunidad de trading y deseas conectar de forma masiva los terminales de tus alumnos o integrar los resultados en un dashboard corporativo mediante Webhooks, escribe directamente a nuestro soporte de integraciones en api@clarity-journal.com.