API pública de señales CQS

Inicio rápido

La API pública hace una cosa principal: devolver señales de trading abiertas publicadas por CQS dentro de una ventana de tiempo que tú eliges. Envías tu api_key, lees el JSON y procesas el array signals.

1. Elige tu clave: FREE para señales públicas, o el ID de tu suscripción premium desde el panel de CQS.
2. Haz GET o POST en https://api.cryptoqualitysignals.com/getSignal/ con esa clave.
3. Analiza el array signals. Cada elemento incluye zona de entrada, objetivos, stop loss, exchange y dirección.

Solicitud mínima (plan gratuito, últimos 5 minutos):

curl -s "https://api.cryptoqualitysignals.com/getSignal/?api_key=FREE&interval=5"

Autenticación

Toda solicitud necesita api_key. No hay token Bearer aparte — pasa la clave como parámetro de query (GET) o campo de formulario (POST).

Acceso gratuito

Usa la cadena literal FREE. Recibes señales de los canales free y freemium. El volumen y los tipos son más limitados que en premium.

Acceso premium

Tras suscribirte, tu cuenta recibe un ID de suscripción único — una cadena alfanumérica larga. Ese valor es tu api_key. Cópialo exactamente desde el panel premium.

Las claves premium desbloquean señales VIP. Claves incorrectas, expiradas o inactivas devuelven código de error 5.

El endpoint getSignal

GET y POST se comportan igual. GET es útil para pruebas rápidas; POST funciona si prefieres cuerpo de formulario.

Ruta alternativa (mismo handler): https://api.cryptoqualitysignals.com/api/v1/getSignal

Parámetros de la solicitud

POST usa los mismos nombres de campo: api_key, interval, exchange, currency, type.

Formato de la respuesta

Toda respuesta usa el mismo sobre:

{
  "error": 0,
  "message": "Success",
  "count": 2,
  "signals": [ ... ]
}

• error — Estado numérico (0 = OK). Consulta los códigos de error.
• message — Estado legible para logs.
• count — Longitud del array signals.
• signals — Lista de objetos de señal; vacía cuando no hay coincidencias.

Ejemplo (una señal, los campos pueden variar):

{
  "error": 0,
  "message": "Success",
  "count": 1,
  "signals": [
    {
      "id": "1847291",
      "timestamp": "2026-05-24 14:32:05",
      "exchange": "binance",
      "currency": "USDT",
      "coin": "BTC",
      "direction": "LONG",
      "buy_start": "94250.5",
      "buy_end": "94400",
      "target1": "95500",
      "target2": "96200",
      "target3": "97000",
      "stop_loss": "93100",
      "type": "SHORT TERM",
      "ask": "94325",
      "risk_level": "3"
    }
  ]
}

Cuando no hay nada disponible: error 0, message "No new signals available", count 0, signals [].

Campos de la señal explicados

Los precios se devuelven como cadenas para evitar sorpresas de punto flotante. Análalos como decimales en tu lenguaje.

Tipos de señal

Pasa una de estas cadenas exactas en el parámetro type (espacios y barras incluidos):

• SHORT TERM
• SHORT/MID TERM
• SCALPING
• MID TERM
• LONG TERM

Tipo desconocido → error 1 con mensaje descriptivo.

Acceso gratuito vs premium

Scalping (plan gratuito)

Las señales de scalping gratuitas usan una tabla separada. Solicítalas con api_key=FREE y type=SCALPING.

• Solo target1 está definido (take-profit único).
• buy_start / buy_end están a ±0,1% del ask.
• risk_level es siempre 3.
• Los scalps de BitMEX quedan excluidos del feed gratuito.

curl -s "https://api.cryptoqualitysignals.com/getSignal/?api_key=FREE&type=SCALPING&interval=10"

Exchanges de futuros y apalancamiento

Las señales de futuros usan los códigos de exchange listados abajo. Use el valor exacto del campo exchange al filtrar con el parámetro exchange.

Códigos de exchange de futuros soportados

La mayoría de las filas usan minúsculas (p. ej. binance_futures). El filtro debe coincidir exactamente con el valor almacenado.

• binance_futures Binance Futures
• bitget_futures Bitget Futures
• bitmex BitMEX
• bybit Bybit
• deribit Deribit
• htx_futures HTX Futures
• kucoin_futures Kucoin Futures
• okx_futures OKX Futures

Campo leverage

Al filtrar por cualquier código de futuros listado arriba, la respuesta incluye leverage — normalmente el punto medio de nuestro rango min/max. Sin filtro de exchange, leverage se omite incluso en señales de futuros.

Confirma el tipo de contrato y el apalancamiento máximo en tu exchange antes de operar automáticamente.

Códigos de error

Con qué frecuencia consultar

No hay webhook para entrega pública — consultas según un intervalo.

• Cada 30–60 segundos para scalping; 2–5 minutos suele bastar para señales swing.
• Define interval un poco más amplio que tu periodo de consulta para no perder señales entre solicitudes.
• Deduplica por id. La API devuelve todas las señales abiertas coincidentes en la ventana, no solo las más recientes.
• En error 4 o 5 con "unavailable", espera antes de reintentar.

Bots y plataformas de trading

El premium de CQS funciona de forma nativa con 3Commas, Cornix, Zignaly, AnnyDeCrypto, Le-Trader, Nefertiti, 3C.exchange y otros. Esas herramientas piden tu ID de suscripción en su interfaz — no hace falta parsear JSON salvo que quieras una configuración personalizada.

¿Montas tu propio bot? Mapea coin + currency al símbolo del exchange, respeta direction, entra entre buy_start y buy_end, pon el stop en stop_loss y escala salidas en target1–target3. Prueba primero en paper trading.

Ejemplos de código

GET — premium, Binance USDT, corto plazo

curl -G "https://api.cryptoqualitysignals.com/getSignal/" \
  --data-urlencode "api_key=YOUR_SUBSCRIPTION_ID" \
  --data-urlencode "interval=15" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "currency=USDT" \
  --data-urlencode "type=SHORT TERM"

POST — cuerpo de formulario

curl -s -X POST "https://api.cryptoqualitysignals.com/getSignal/" \
  -d "api_key=FREE" \
  -d "interval=5" \
  -d "type=SCALPING"

Python

import requests

API_KEY = "YOUR_SUBSCRIPTION_ID"  # or "FREE"
url = "https://api.cryptoqualitysignals.com/getSignal/"
params = {"api_key": API_KEY, "interval": 10, "exchange": "binance", "currency": "USDT"}

resp = requests.get(url, params=params, timeout=30)
data = resp.json()
if data["error"] != 0:
    raise RuntimeError(f"API error {data['error']}: {data['message']}")

seen = set()
for sig in data["signals"]:
    if sig["id"] in seen:
        continue
    seen.add(sig["id"])
    print(sig["coin"], sig["direction"], sig["ask"])

JavaScript (Node 18+)

const params = new URLSearchParams({ api_key: "FREE", interval: "5" });
const res = await fetch(`https://api.cryptoqualitysignals.com/getSignal/?${params}`);
const data = await res.json();
if (data.error !== 0) throw new Error(`${data.error}: ${data.message}`);
for (const s of data.signals) console.log(s.id, s.coin);

PHP

$q = http_build_query(['api_key' => 'FREE', 'interval' => 5]);
$json = file_get_contents('https://api.cryptoqualitysignals.com/getSignal/?' . $q);
$data = json_decode($json, true);
if ($data['error'] !== 0) throw new Exception($data['message']);
foreach ($data['signals'] as $s) echo $s['id'], ' ', $s['coin'], PHP_EOL;

Preguntas frecuentes

¿Dónde encuentro mi ID de suscripción?

Inicia sesión en el panel premium de CQS tras la compra. Copia el ID de suscripción exactamente en api_key.

¿Por qué veo la misma señal dos veces?

Las señales abiertas permanecen en el feed hasta que las cerramos. Registra los valores de id que ya procesaste.

¿Se devuelven señales cerradas o con objetivo alcanzado?

No. Solo se incluyen señales abiertas dentro de la ventana de tiempo.

¿Es obligatorio HTTPS?

Sí. Usa siempre https://. Nunca envíes una clave premium por HTTP sin cifrar.

¿Necesitas ayuda?

Miembros premium: usa el canal de soporte incluido en tu plan. En caso de caída, prueba una solicitud FREE antes de abrir un ticket.