Filtro de noticias gratis para tu EA de MT4/MT5: la API de NinjaBull

Tu EA opera según lo que ve en el gráfico, y las noticias económicas, como los datos de empleo de EE. UU. o una decisión de un banco central, nunca llegan al código. La API de NinjaBull añade ese lado de las noticias como una señal que tu EA puede leer. NinjaBull es una de las herramientas gratuitas que ofrece ForexFanClub.

¿Cómo filtra NinjaBull las operaciones de tu EA?

Tu EA revisa la señal antes de cada nueva operación y omite las operaciones que van en contra del análisis. La IA de NinjaBull lee los últimos datos económicos, titulares y gráficos del oro (XAU/USD) y de Bitcoin (BTC/USD) y convierte el resultado en una sola señal. Tus reglas técnicas de entrada siguen iguales, y la API solo decide cuáles de las operaciones omite tu EA.

• Señal BUY
  El análisis favorece comprar. Tu EA toma sus entradas de compra y omite las ventas.
• Señal SELL
  El análisis favorece vender. Tu EA toma sus entradas de venta y omite las compras.
• Señal WAIT
  El análisis no da una dirección clara, así que el EA no abre ninguna operación nueva.

Prepárate para muchas señales WAIT. En nuestra prueba del 3 al 6 de noviembre, 33 de los 64 análisis del oro dieron WAIT, 19 dieron SELL y 12 dieron BUY. En Bitcoin, 26 de los 50 análisis dieron WAIT, 23 dieron SELL y 1 dio BUY. Así que un EA que opera solo con la señal se queda fuera del mercado durante gran parte de la semana.

El score añade un segundo filtro. Cerca de 0 significa que la presión vendedora es fuerte, cerca de 100 significa que la presión compradora es fuerte, y 50 es neutral.

Por ejemplo, tu EA puede tomar una venta solo cuando la puntuación es 45 o menos. Un límite más estricto significa menos operaciones, así que prueba tu límite en una cuenta demo antes de usar ese límite con dinero real.

¿Cómo consultas la API de NinjaBull?

Tu EA envía una sola solicitud GET a la dirección de la API con dos parámetros, key y pair. No necesitas encabezados adicionales ni iniciar sesión. La dirección de la API es:

https://fxfan.club/es/ninjabull/api_ea.php

Elemento	Valor
Método	HTTP GET
Autenticación	parámetro key (obligatorio)
Formato de datos	JSON

• key
  La API todavía está en beta, así que todos usan la misma clave compartida, NINJABULL_VIP_2026. No necesitas registrarte ni esperar una aprobación.
• pair
  La API funciona para XAU/USD y BTC/USD, escritos con la barra. Otros pares devuelven un error.

Una solicitud para el oro se ve así:

https://fxfan.club/es/ninjabull/api_ea.php?key=NINJABULL_VIP_2026&pair=XAU/USD

Antes de que tu EA pueda consultar la dirección, MT4 o MT5 debe permitir la conexión. Abre Herramientas, luego Opciones, luego la pestaña Asesores Expertos, marca Permitir WebRequest para las siguientes URL y añade https://fxfan.club.

Más adelante planeamos reemplazar la clave compartida por una clave privada para cada usuario. Así que guarda la clave en una variable input de tu EA en lugar de escribir la clave en el código. Cuando la clave cambie, solo cambias un ajuste y no necesitas editar el EA.

¿Qué devuelve la API de NinjaBull?

La API devuelve una respuesta JSON corta con cinco campos, y signal es el campo que tu EA necesita.

Campo	Tipo	Contenido
pair	string	Par de divisas objetivo
score	entero (0-100)	Estimación de la IA sobre la dirección: cerca de 0 venta, cerca de 100 compra, 50 neutral
signal	string	Uno de BUY, SELL o WAIT
action_en	string	El plan en pocas palabras
timestamp	string (UTC)	Hora del último análisis

Por ejemplo, una respuesta para el oro se ve así:

{"pair":"XAU/USD","score":47,"signal":"WAIT","action_en":"Stay flat before US payrolls","timestamp":"2026-11-06T05:00:42Z"}

action_en es el mismo plan que NinjaBull muestra en letras grandes. Escribe el plan en el registro (log) de tu EA, y así podrás ver después por qué el EA operó o esperó.

¿Por qué la puntuación es neutral y la señal SELL?

La signal lee primero las palabras del plan y después la puntuación. El 6 de noviembre, por ejemplo, Bitcoin tenía una puntuación de 44, que NinjaBull muestra como NEUTRAL, pero el plan era “Sell rallies in BTC/USD”, así que la señal fue SELL. La API revisa las reglas en orden y se detiene en la primera regla que coincide.

1. Si el plan contiene WAIT o STANDBY, o la puntuación es exactamente 50, la señal es WAIT.
2. Si el plan contiene BUY o LONG, o la puntuación es 60 o más, la señal es BUY.
3. Si el plan contiene SELL o SHORT, o la puntuación es 40 o menos, la señal es SELL.
4. En cualquier otro caso, la señal es WAIT. “Stay flat before US payrolls” con 47 es un ejemplo.

Así que un SELL con 44 y un SELL con 30 son visiones distintas, y solo el score muestra la diferencia. La mayoría de las puntuaciones están cerca de 50. Los 114 análisis de nuestra prueba puntuaron entre 40 y 55, así que un límite como 30 detendría casi todas las operaciones.

¿Cada cuánto se actualiza la señal de NinjaBull?

La señal se actualiza cuando algo pasa en el mercado, no a una hora fija. Un nuevo análisis empieza después de datos económicos, un titular importante o un movimiento grande del precio, y también en las aperturas de Tokio, Londres y Nueva York. Si no hay actualización en 6 horas, se ejecuta un nuevo análisis de todos modos. Cómo funciona NinjaBull enumera todos los casos.

En nuestra prueba del 3 al 6 de noviembre, el oro se actualizó unas 20 veces al día y Bitcoin unas 16 veces al día. La mitad de los intervalos entre dos análisis del oro fueron de menos de 50 minutos, y el intervalo más largo fue de poco menos de 5 horas.

Una consulta cada 5 minutos es suficiente para tu EA, porque NinjaBull busca un motivo para actualizar cada 5 minutos. Guarda ese intervalo en un ajuste input.

// Recommended: keep it external
input int API_REFRESH_MINUTES = 5;  // NinjaBull looks for a reason to update every 5 minutes

Después de una publicación de datos, la nueva señal llega entre 5 y 20 minutos más tarde. Así que en los primeros minutos tras la publicación, tu EA todavía lee el análisis de antes de que saliera el dato.

El campo timestamp te dice qué tan antigua es la señal, así que haz que tu EA revise el timestamp antes de que el EA actúe. En un día de semana, un timestamp de más de 7 horas significa que la actualización se detuvo, porque la API conserva el último resultado cuando un análisis falla.

El fin de semana, el oro conserva la última señal del viernes, así que tu EA puede ignorar la señal del oro hasta el lunes. Bitcoin sigue actualizándose el fin de semana, pero solo después de un movimiento grande del precio o tras 6 horas sin actualización.

¿La señal pasa a WAIT antes de cada publicación?

La señal todavía puede decir BUY o SELL unos minutos antes de una publicación de datos, así que la API no reemplaza un calendario de noticias en tu EA. La IA suele escribir un plan como “Stay flat before US payrolls”, y ese plan da WAIT. Sin embargo, la API no tiene un campo con la hora de la próxima publicación.

Si tu EA debe dejar de operar alrededor de las publicaciones importantes, mantén tu propia regla de horario para esas publicaciones y usa la señal como filtro de dirección.

¿En qué idioma está la API?

La API de NinjaBull está en inglés. El campo action_en siempre está en inglés, y los valores de signal siempre son BUY, SELL o WAIT.

¿Qué significan los errores de la API de NinjaBull?

Un error 401 significa que la clave es incorrecta, un error 404 significa que el par es incorrecto, y un error 500 es un problema de nuestro lado. Con un 401 o 404, volver a intentarlo da el mismo error, así que haz que tu EA deje de consultar la API y revisa la solicitud.

401 Unauthorized

Si la clave es incorrecta o falta, la API devuelve HTTP 401 con el mensaje “Invalid or Missing API Key”.

404 Not Found

Si el par no es XAU/USD ni BTC/USD, la API devuelve HTTP 404 con el mensaje “State not found”. Un par sin barra, como XAUUSD, devuelve el mismo error.

500 Server Error

Si nuestra base de datos no responde, la API devuelve HTTP 500 con el mensaje “Database Connection Failed”. Tu EA puede volver a intentarlo en la siguiente consulta de 5 minutos. Decide de antemano qué hace el EA mientras la API está caída, por ejemplo no abrir operaciones nuevas.

¿Qué límites tiene la API de NinjaBull?

La API da la visión de la IA sobre el mercado, así que tu EA sigue necesitando sus propias reglas de entrada, stop y tamaño de posición. La API no envía precio de entrada, ni nivel de stop, ni tamaño de lote.

El score es la estimación propia de la IA, así que la puntuación no es una tasa de acierto medida y no promete un resultado. Estamos preparando una página con los resultados pasados de NinjaBull.

La API es gratis para tu propio EA y tus propios scripts. Por favor, no revendas los datos ni publiques los datos en otro sitio o app.

¿Qué página necesitas ahora?

Abre NinjaBull para ver el análisis actual en una sola pantalla, o lee cómo funciona NinjaBull antes de integrar la señal en tu EA.