Documentación API

🚀 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 = api_key + timestamp
signature = 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

Extra Data (datos adicionales por tipo de acción)

El campo extra_data varía según la acción:

Campos de Control

Campos de Confianza

Campos de Estado y Tiempo

Ejemplo de Respuesta

{
  "success": true,
  "count": 1,
  "signals": [
    {
      // Identificación
      "signal_id": 12345,
      "symbol": "DDOG",

      // Acción
      "action": "BUY_NEW",
      "action_type": "BUY_NEW",
      "quantity": 50,

      // Precio de entrada
      "entry_price": 140.42,

      // Confianza del modelo ML
      "kelly_fraction": 0.75,
      "confidence": 0.75,

      // Control
      "tif": "DAY",
      "close_positions": false,

      // Datos adicionales según tipo de acción
      "extra_data": {
        "tif": "DAY",
        "entry_price": 140.42,
        "reason": "nueva_posicion",
        "kelly_fraction": 0.75,
        "capital_pct": 0.15
      },

      // Estado
      "is_active": true,
      "expires_at": "2025-12-20T15:35:00Z",
      "time_to_live_minutes": 5
    }
  ],
  "timestamp": "2025-12-20T15:30:05Z",
  // null cuando el mercado opera con normalidad
  "system_status": null
}

👤 Estructura de Cuenta /account

El endpoint GET /api/v1/account devuelve la información completa de la cuenta autenticada.

Campos Principales

Objeto usage — Uso Actual

Objeto trial_info — Solo en plan Sandbox

Presente únicamente cuando plan = sandbox. null en planes de pago.

Ejemplo de Respuesta

{
  "success": true,
  "account": {
    "email": "user@example.com",
    "plan": "basic",
    "status": "active",
    "monthly_fee": 79.0,
    "rate_limit_per_minute": 8,
    "history_days": 7,
    "current_period_end": "2026-05-04T18:00:00Z",
    "trial_info": null,
    "usage": {
      "active_connections": 1,
      "max_connections": 1,
      "total_requests": 1240
    },
    "created_at": "2026-03-09T14:28:53Z"
  },
  "timestamp": "2026-03-09T18:06:01Z"
}

🎯 Tipos de Acción

El campo action puede tener los siguientes valores:

Acciones de Apertura

Acciones de Cierre

Órdenes de Protección de Capital

⏱️ 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/api/v1"
SESSION_ID = str(uuid.uuid4())

def get_headers():
    timestamp = str(int(time.time()))
    message = API_KEY + timestamp
    signature = hashlib.sha256((API_SECRET + message).encode()).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']} @ ${s.get('entry_price', 'N/A')}")

    # Kelly fraction (confianza del modelo ML)
    if s.get('kelly_fraction'):
        print(f"  Kelly: {s['kelly_fraction']}")

Python - Procesar Acciones

def process_signal(signal):
    action = signal.get('action')
    symbol = signal.get('symbol')
    extra = signal.get('extra_data', {})

    if action == 'BUY_NEW':
        # Abrir nueva posicion LONG
        execute_buy(
            symbol=symbol,
            quantity=signal.get('quantity'),
            entry_price=signal.get('entry_price')
        )

    elif action == 'COVER_SHORT':
        # Cerrar posicion SHORT (buy-to-cover)
        cover_short(symbol, signal.get('quantity'))

    elif action == 'SELL_ALL':
        # Cerrar toda la posicion
        close_position(symbol, signal.get('quantity'))

    elif action == 'SELL_PARTIAL':
        # Venta parcial (profit-taking)
        partial_sell(symbol, signal.get('quantity'),
                     extra.get('sell_percentage'))