Construye sobre Flicker

Especificaciones y referencias

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.

Base URL

https://api.flicker.finance

Versions

/v1/ /v2/

OpenAPI

https://api.flicker.finance/docs/openapi.json

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>

Key scope

/v2/analysis /v2/assets /v2/insights /v2/config /v1/exchanges

Credits

GET https://api.flicker.finance/v1/users/api_keys/credits

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

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

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.

Budget

2000 / 60s

Headers

x-ratelimit-limit x-ratelimit-remaining x-ratelimit-used x-ratelimit-window retry-after

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": "…"
}

ErrorResponse · 400 · 401 · 402 · 403 · 404 · 410 · 422 · 500 · 503

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.

Un servidor Model Context Protocol sobre Streamable HTTP, para que Claude, ChatGPT, Cursor y cualquier otro cliente MCP llamen a Flicker como herramientas. La autorización es OAuth 2.1: apunta tu cliente al endpoint y él descubre el resto a partir de la respuesta.

https://api.flicker.finance/mcp

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 miles de activos 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.