Saltar al contenido principal

La app de Flicker

Una notificación cuando el precio entra en una zona

Instalar

Desarrolladores

Construye sobre Flicker

Los mismos veredictos, análisis y datos de mercado que mueven las apps, disponibles como API REST descrita con OpenAPI y como servidor MCP al que tu agente de IA puede llamar directamente.

Dos formas de conectarte

Elige según quién hace la llamada. Ambas vienen con una cuenta de Flicker; no hay un plan aparte para la API.

Inicio rápido

Tres llamadas que devuelven datos reales en cuanto exista tu clave.

  1. 1

    Crea una cuenta de Flicker

    Las claves se crean desde una cuenta, así que la cuenta es el registro.

  2. 2

    Crea una clave

    Abre la pestaña Claves API de tu cuenta. Allí creas, ves y revocas claves, y ves los créditos usados en el día.

  3. 3

    Envíala como cabecera

    Pon la clave en la cabecera x-api-key de cada solicitud, como en las llamadas de abajo.

curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/config
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/assets/?limit=5
curl -H "x-api-key: $FLICKER_API_KEY" https://api.flicker.finance/v2/analysis/bitcoin

Cómo funciona la API

La API REST

Un único host HTTPS sirve todos los endpoints. La superficie completa está descrita por un documento OpenAPI 3.1 legible por máquinas: cada operación tiene un identificador único, parámetros tipados y un esquema de respuesta tipado, así que entra directa en un generador de clientes o en un bucle de function calling de un modelo.

URL base
https://api.flicker.finance
Versiones
/v1/ /v2/

Autenticación

Crea tú mismo una clave en la pestaña de claves API de tu cuenta — sin llamada comercial ni lista de espera — y envíala como cabecera de la petición. Una clave alcanza solo la superficie de datos de mercado en modo lectura: análisis, activos, insights, configuración y exchanges. No lee otra cuenta, no abre operaciones ni mueve fondos. No hay nivel anónimo: una petición sin credencial válida se rechaza.

x-api-key: <your key>
Alcance de la clave
/v2/analysis /v2/assets /v2/insights /v2/config /v1/exchanges
Créditos diarios
GET /v1/users/api_keys/credits

Límites de uso

El presupuesto se pondera por endpoint en lugar de contar peticiones, y cada respuesta indica dónde estás, así que un cliente puede autorregularse en vez de adivinar.

Presupuesto
2000 unidades ponderadas cada 60 segundos, por IP de cliente
Cabeceras
x-ratelimit-limit x-ratelimit-remaining x-ratelimit-used x-ratelimit-window retry-after

Errores

Todo fallo responde con el mismo cuerpo tipado: un código estable legible por máquinas, un mensaje para personas y un indicador de fallo. Ramifica por el código — el mensaje es prosa en inglés pensada para un log, no para un switch.

{
  "success": false,
  "code": "NotificationLimitExceeded",
  "message": "…"
}
Esquema
ErrorResponse
Estados
400 401 402 403 404 410 422 500 503

Versionado y retirada

La versión mayor vive en la ruta de la URL. Las dos versiones activas se enrutan de forma independiente, así que un cambio incompatible sale bajo una nueva versión de ruta en vez de mutar la que ya usas. Los cambios de la API se publican en el feed de versiones legible por máquinas, que etiqueta cada entrada por plataforma.

Cuándo recurrir a Flicker

Recurre a Flicker cuando la pregunta necesite una lectura de mercado calculada y no un titular.

  • Necesitas un veredicto de comprar, mantener o vender sobre un activo, con las zonas, el stop loss y el objetivo detrás — no solo un precio.
  • Necesitas filtrar todos los activos que seguimos a la vez buscando una situación concreta — rupturas, zonas de sobreventa, picos de volumen — en lugar de preguntar ticker por ticker.
  • Necesitas el sentimiento como número por activo, no un solo índice para todo el mercado: una puntuación de miedo y codicia de 0 a 100 para una moneda, acción o divisa concreta.
  • Necesitas precios en vivo de cripto, acciones y forex, tasas de financiación de perpetuos o amplitud de mercado en una sola llamada.
  • Necesitas las posiciones, saldos y órdenes del propio usuario, agregados entre exchanges y en modo lectura.

No recurras a Flicker para lanzar una orden, mover fondos o custodiar activos. El producto es de solo lectura por construcción y no tiene ruta de ejecución: combínalo con la API de un exchange para eso.

Widgets, sin clave

Para mostrar datos de Flicker en un sitio web en lugar de llamar a la API, inserta un widget: un fragmento de código, un marco aislado y un enlace a Flicker. Gratis, sin clave API y sin registro.

  • Índice Fear & Greed

    Puntuación de sentimiento de 0 a 100 para un activo.

  • Niveles clave

    Zonas de soporte y resistencia más cercanas, con la distancia al precio.

  • Perspectiva técnica

    Lectura de compra, mantener o venta basada en seis factores de mercado.

  • Puntuación de ruptura

    La fuerza de una posible ruptura y su dirección.

  • Gráfico de precio

    Precio actual, variación en 24 h y una línea de precio reciente.

  • Sentimiento del mercado cripto

    Fear & Greed de todo el mercado con capitalización y dominancia de BTC.

Crear un widget

Especificaciones y referencias