API Documentation

RESTful API para Copy Trading Platform

Base URL

https://copytradingglobal.com/api

Autenticación

POST /register

Registrar un nuevo usuario

{
  "name": "John Doe",
  "email": "john@example.com",
  "password": "password123",
  "password_confirmation": "password123"
}
POST /login

Iniciar sesión y obtener token

{
  "email": "demo@copytrading.com",
  "password": "password"
}

Response:

{
  "user": { "id": 1, "name": "Demo", "email": "..." },
  "token": "1|abc123...",
  "token_type": "Bearer"
}
POST /logout

Cerrar sesión (requiere autenticación)

Headers:

Authorization: Bearer {token}

Cuentas MT

GET /accounts

Listar todas las cuentas del usuario

POST /accounts

Crear nueva cuenta MT

{
  "account_number": "12345678",
  "broker": "IC Markets",
  "platform": "MT5",
  "server": "ICMarkets-Demo",
  "password": "password",
  "account_type": "demo",
  "nickname": "My Trading Account",
  "leverage": 500
}
GET /accounts/{id}/statistics?days=30

Obtener estadísticas de una cuenta

POST /accounts/{id}/sync

Sincronizar cuenta con MetaTrader

Trade Copiers

POST /copiers

Crear nuevo trade copier

{
  "master_account_id": 1,
  "name": "EUR/USD Copier",
  "risk_type": "multiplier",
  "risk_value": 0.5,
  "copy_stop_loss": true,
  "copy_take_profit": true,
  "include_symbols": ["EURUSD", "GBPUSD"]
}

Risk Types:

  • • fixed_lot - Lote fijo
  • • multiplier - Multiplicador del lote master
  • • balance_percentage - Porcentaje del balance
  • • equity_percentage - Porcentaje del equity
POST /copiers/{id}/followers

Agregar cuenta follower

{
  "follower_account_id": 2,
  "custom_risk_value": 0.3,
  "is_active": true
}
POST /copiers/{id}/toggle

Activar/Desactivar copier

Signals

POST /signals

Crear nueva señal

{
  "mt_account_id": 1,
  "name": "Pro Signals",
  "description": "High win rate signals",
  "pricing_type": "monthly",
  "price": 49.99,
  "is_public": true
}
POST /signals/{id}/subscribe

Suscribirse a una señal

{
  "follower_account_id": 2
}
GET /signals/leaderboard?limit=10

Ranking de mejores señales

Equity Monitors

POST /equity-monitors

Crear monitor de equity

{
  "mt_account_id": 1,
  "name": "Stop Loss Monitor",
  "trigger_type": "equity_percentage",
  "trigger_value": 80,
  "comparison": "below",
  "send_email_alert": true,
  "close_all_trades": true
}

Trigger Types:

  • • equity_amount - Monto de equity
  • • equity_percentage - Porcentaje de equity
  • • balance_amount - Monto de balance
  • • profit_amount - Monto de profit

Rate Limiting

Límite: 60 requests por minuto por IP
Headers: X-RateLimit-Limit, X-RateLimit-Remaining

Error Responses

401 Unauthorized 
{ "message": "Unauthenticated." }
422 Unprocessable Entity 
{ "message": "Validation error", "errors": {...} }
404 Not Found 
{ "message": "Resource not found" }

Credenciales de Prueba

Email: demo@copytrading.com

Password: password

Usa estas credenciales para probar la API sin necesidad de registro