La página Developers: usa la API de FxMind desde un script o una hoja de cálculo

Una API es una forma de que un programa, y no una persona, le pida datos a FxMind. Tu script envía una petición a una dirección y recibe JSON (un formato de texto que leen tanto las hojas de cálculo como el código). La guía es la página /app/developers. No tiene entrada en el menú: ábrela desde Ajustes > API con Leer la guía de la API, o escribe la dirección.

Quién la tiene

El acceso a la API forma parte de los planes Elite y Desk. En otro plan, Ajustes > API lo dice y muestra Ver planes; las claves que hiciste antes siguen en la lista como Pausada y vuelven a funcionar cuando el plan incluya la API. Crear una clave también exige verificación en dos pasos: configura antes una app de autenticación o una passkey.

Qué puede hacer

Leer tu diario

Cuentas (nunca un login ni una contraseña), operaciones con su revisión, etiquetas, estadísticas e informes agrupados. Permiso journal:read.

Leer datos de mercado

El calendario de noticias en UTC, hasta 31 días cada vez, y los resúmenes de mercado escritos de hoy. Permiso market:read.

Alarmas de precio

Listar tus alarmas, crear una o borrar una. Permisos alarms:read y alarms:write.

Nunca operar

No existe un permiso para abrir, modificar o cerrar una operación a través de la API.

Crea una clave y haz tu primera llamada

1. 1Abre Ajustes > API y pulsa Nueva clave.
2. 2Escribe un Nombre que diga dónde la usarás, por ejemplo Exportar a Sheets.
3. 3Marca solo los permisos que necesita el script. Puedes cambiarlos después con Editar; la clave en sí sigue siendo la misma.
4. 4Elige una Caducidad: 30 días, 90 días, 1 año o Nunca. Una clave que caduca hace menos daño si se filtra.
5. 5Confirma que eres tú con tu app de autenticación o passkey. La clave completa, que empieza por fxm_, se muestra una sola vez. Cópiala en los ajustes secretos de tu script, por ejemplo en una variable de entorno llamada FXMIND_API_KEY.
6. 6En la página Developers, copia el ejemplo ¿Funciona mi clave? en curl, Python o JavaScript y ejecútalo. Llama a /api/v1/me y responde con el nombre de la clave, sus permisos y cuántas llamadas le quedan hoy.

Cada llamada envía la clave en una cabecera: Authorization: Bearer fxm_.... Nunca pongas la clave en la dirección: FxMind la rechaza ahí y debes revocar esa clave, porque las direcciones acaban en registros. La dirección base es https://api.fxmind.ai/api/v1.

Los ejemplos de la página

• ¿Funciona mi clave? La llamada más pequeña.
• Todos los trades cerrados desde una fecha. Las operaciones llegan de la más nueva a la más antigua, hasta 500 por página. Cuando nextCursor no es null, pide de nuevo con él para la página siguiente. El dinero va en centavos: divide entre 100.
• Crear una alarma de precio. La misma alarma que crea la Mesa. Se aplica el límite de alarmas de tu plan.

Debajo de los ejemplos, una tabla lista cada dirección con su permiso, y la página muestra el contrato completo como un documento OpenAPI que puedes importar en Postman o Insomnia.

Límites y formatos

• 60 llamadas por minuto por clave. Por encima recibes rate_limited (429): espera los segundos de la cabecera Retry-After.
• 10,000 llamadas al día por clave, contadas en UTC. El conteo se reinicia a las 00:00 UTC. Cada respuesta lleva X-Quota-Remaining.
• Hasta 10 claves activas a la vez. Las claves revocadas siguen en la lista 30 días.
• El dinero va en centavos enteros de la moneda de la cuenta, con su código al lado. Las monedas distintas nunca se suman.
• Las horas van en UTC en ISO 8601, por ejemplo 2026-09-27T14:30:00Z.

Cuando una llamada es rechazada

api_key_required (401)

No enviaste clave. Ponla en la cabecera Authorization.

invalid_api_key (401)

La clave está incompleta o no es válida. Si la perdiste, revócala y crea otra.

api_key_revoked o api_key_expired (401)

Crea una clave nueva en Ajustes > API.

key_in_url (400)

Pasa la clave a la cabecera y luego revoca esa clave.

insufficient_scope (403)

A la clave le falta el permiso que necesita la llamada. Crea una que lo tenga.

api_plan_suspended (403)

Tu plan no incluye ahora la API. Las claves vuelven a funcionar cuando lo incluya.

rate_limited o daily_quota_reached (429)

Espera, o vuelve después de las 00:00 UTC.

too_many_attempts (429)

Demasiadas claves erróneas desde tu dirección. Espera 10 minutos.

Cuida tus claves

• Una clave por script, con solo los permisos que necesita y una caducidad.
• Guarda las claves en variables de entorno o en un gestor de contraseñas, nunca en una hoja de cálculo que abran otras personas.
• Cada clave nueva se te envía por email, y la lista muestra cuándo y desde dónde se usó por última vez.
• Si una clave pudo filtrarse, pulsa Revocar en Ajustes > API. Deja de funcionar en su siguiente llamada.

Webhooks y apps de IA

La página Developers cubre solo la API. La pestaña Webhooks de Ajustes es la otra dirección: una alerta de TradingView llama a FxMind. Mira webhooks de TradingView. Para conectar Claude, Cursor u otra app de IA con una clave, mira conecta tu propia IA. Asientos y claves en Desk: asientos de equipo y claves de API.