Documentación API v2.0

🚀 Introducción

La API de B.E.N.D.E.R. te permite acceder a las señales de trading REALES generadas por el Bot Master especializado en NASDAQ 100.

🌐 Base URL

🔐 Autenticación HMAC

Todas las peticiones requieren autenticación HMAC-SHA256.

Headers Requeridos

Generar Firma

message = timestamp + api_key
signature = HMAC-SHA256(api_secret, message)

📡 Endpoints

📋 Estructura de Señal

Cada señal del endpoint /signals contiene los siguientes campos:

Campos de Identificación

Campos de Acción

Campos de Precios

Campos de Trailing Stop NUEVO

Campos de Control NUEVO

Campos de Confianza

Campos de Estado y Tiempo

Ejemplo de Respuesta

{
  "success": true,
  "count": 2,
  "signals": [
    {
      // Identificación
      "signal_id": 12345,
      "symbol": "TSLA",
      
      // Acción
      "action": "BUY",
      "action_type": "BUY",
      "quantity": 10,
      
      // Precios
      "entry_price": 245.50,
      "price": 245.50,
      "stop_loss": 240.00,
      "take_profit": 260.00,
      "stop_price": null,
      "target_exit_price": 258.00,
      
      // Trailing Stop
      "trail_amount": 2.50,
      "trailing_stop_pct": null,
      
      // Control
      "order_id": null,
      "tif": "DAY",
      "close_positions": false,
      
      // Confianza
      "confidence": 0.75,
      "kelly_fraction": 0.75,
      
      // Estado
      "status": "active",
      "is_active": true,
      "created_at": "2025-12-20T15:30:00Z",
      "expires_at": "2025-12-20T15:35:00Z",
      "time_to_live_minutes": 5
    }
  ],
  "timestamp": "2025-12-20T15:30:05Z"
}

🎯 Tipos de Acción

El campo action puede tener los siguientes valores:

Acciones de Trading

Acciones de Gestión

Acciones de Órdenes Límite

⏱️ Rate Limits

💰 Planes

❌ Códigos de Error

💻 Ejemplos de Código

Python - Obtener Señales

import hmac, hashlib, time, uuid, requests

API_KEY = "bdr_live_tu_api_key"
API_SECRET = "tu_api_secret"
BASE_URL = "https://api.benderbot.es:5001/api/v1"
SESSION_ID = str(uuid.uuid4())

def get_headers():
    timestamp = str(int(time.time()))
    message = f"{timestamp}{API_KEY}"
    signature = hmac.new(API_SECRET.encode(), message.encode(), hashlib.sha256).hexdigest()
    return {
        "X-API-Key": API_KEY,
        "X-Timestamp": timestamp,
        "X-Signature": signature,
        "X-Session-ID": SESSION_ID
    }

# Obtener señales
response = requests.get(f"{BASE_URL}/signals", headers=get_headers())
data = response.json()

for s in data.get("signals", []):
    print(f"{s['action']} {s['quantity']} {s['symbol']}")
    
    # Verificar trailing stop
    if s.get('trail_amount'):
        print(f"  Trailing: ${s['trail_amount']}")
    
    # Verificar stop loss
    if s.get('stop_loss'):
        print(f"  Stop Loss: ${s['stop_loss']}")

Python - Procesar Trailing Stop

def process_signal(signal):
    action = signal.get('action')
    symbol = signal.get('symbol')
    
    if action == 'BUY':
        # Ejecutar compra
        execute_buy(
            symbol=symbol,
            quantity=signal.get('quantity'),
            stop_loss=signal.get('stop_loss'),
            take_profit=signal.get('take_profit')
        )
    
    elif action == 'UPDATE_TRAILING_STOP':
        # Actualizar trailing stop
        update_trailing(
            symbol=symbol,
            trail_amount=signal.get('trail_amount'),
            tif=signal.get('tif', 'DAY')
        )
    
    elif action == 'SELL':
        # Cerrar posición
        close_position(symbol)