# Construye sobre Flicker

Las mismas señales, 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.

## 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 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.

## 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.

- Base URL: `https://api.flicker.finance`
- OpenAPI 3.1 document: https://api.flicker.finance/docs/openapi.json
- Interactive reference: https://api.flicker.finance/docs

## 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.

- Header: `x-api-key: <your key>`
- Key scope: `/v2/analysis`, `/v2/assets`, `/v2/insights`, `/v2/config`, `/v1/exchanges`
- Self-serve key management: https://flicker.finance/es/account (API Keys tab)
- Daily credit balance: `GET https://api.flicker.finance/v1/users/api_keys/credits`

## Inicio rápido

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

```bash
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
```

## 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.

- Budget: 2000 weighted units per 60 seconds, per client IP.
- Headers on every response: `x-ratelimit-limit`, `x-ratelimit-remaining`, `x-ratelimit-used`, `x-ratelimit-window`; a 429 adds `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.

```json
{ "success": false, "code": "NotificationLimitExceeded", "message": "…" }
```

Schema: `ErrorResponse` · documented statuses: 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.

- Live versions: `/v1/`, `/v2/`
- Release feed: https://flicker.finance/changelog.json

## Servidor MCP

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.

- Endpoint: `https://api.flicker.finance/mcp`
- Transport: Streamable HTTP · Authorization: OAuth 2.1
- Manifest: https://api.flicker.finance/mcp/manifest.json

---

Canonical HTML: https://flicker.finance/es/developers
Machine-readable index: https://flicker.finance/llms.txt · API: https://api.flicker.finance/docs/openapi.json · MCP: https://api.flicker.finance/mcp