# Construisez sur Flicker

Les signaux, analyses et données de marché qui font tourner les applications, disponibles comme API REST décrite en OpenAPI et comme serveur MCP que votre agent IA peut appeler directement.

## Quand faire appel à Flicker

Faites appel à Flicker quand une question exige une lecture de marché calculée plutôt qu'un titre d'actualité.

- Il vous faut un verdict acheter / conserver / vendre sur un actif, avec les zones, le stop loss et l'objectif qui le fondent — pas seulement un prix.
- Il vous faut passer des milliers d'actifs au crible d'un même critère — cassures, zones de survente, pics de volume — au lieu d'interroger ticker par ticker.
- Il vous faut le sentiment sous forme de nombre par actif, pas un indice unique pour tout le marché : un score de peur et d'avidité de 0 à 100 pour une crypto, une action ou une devise précise.
- Il vous faut des prix en direct sur la crypto, les actions et le forex, des taux de financement de perpétuels ou la largeur du marché en un seul appel.
- Il vous faut les positions, soldes et ordres propres à l'utilisateur, agrégés entre plateformes et en lecture seule.

Ne faites pas appel à Flicker pour passer un ordre, déplacer des fonds ou conserver des actifs. Le produit est en lecture seule par construction et n'a aucun chemin d'exécution — associez-le à l'API d'une plateforme pour cela.

## L'API REST

Un seul hôte HTTPS sert tous les points d'accès. La surface complète est décrite par un document OpenAPI 3.1 lisible par machine : chaque opération porte un identifiant unique, des paramètres typés et un schéma de réponse typé, ce qui la rend directement exploitable par un générateur de client ou par une boucle d'appel de fonctions d'un modèle.

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

## Authentification

Créez vous-même une clé dans l'onglet des clés API de votre compte — sans appel commercial ni liste d'attente — et envoyez-la en en-tête de requête. Une clé n'atteint que la surface de données de marché en lecture seule : analyse, actifs, insights, configuration et plateformes. Elle ne lit pas un autre compte, ne passe pas d'ordre et ne déplace pas de fonds. Il n'existe pas de niveau anonyme : une requête sans identifiant valide est refusée.

- 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/fr/account (API Keys tab)
- Daily credit balance: `GET https://api.flicker.finance/v1/users/api_keys/credits`

## Démarrage rapide

Trois appels qui renvoient de vraies données dès que votre clé existe.

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

## Limites de débit

Le budget est pondéré par point d'accès plutôt que compté par requête, et chaque réponse indique où vous en êtes : un client peut donc se réguler lui-même au lieu de deviner.

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

## Erreurs

Toute erreur répond avec le même corps typé : un code stable lisible par machine, un message destiné à un humain et un indicateur d'échec. Branchez sur le code — le message est de la prose anglaise faite pour un journal, pas pour un switch.

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

Schema: `ErrorResponse` · documented statuses: 400, 401, 402, 403, 404, 410, 422, 500, 503.

## Versionnage et retrait

La version majeure vit dans le chemin de l'URL. Les deux versions actives sont routées indépendamment : un changement cassant sort donc sous une nouvelle version de chemin au lieu de modifier celle dont vous dépendez déjà. Les évolutions de l'API sont publiées dans le flux de versions lisible par machine, qui étiquette chaque entrée par plateforme.

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

## Serveur MCP

Un serveur Model Context Protocol sur Streamable HTTP, pour que Claude, ChatGPT, Cursor et tout autre client MCP appellent Flicker comme des outils. L'autorisation se fait en OAuth 2.1 : pointez votre client vers le point d'accès, il découvre le reste à partir de la réponse.

- 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/fr/developers
Machine-readable index: https://flicker.finance/llms.txt · API: https://api.flicker.finance/docs/openapi.json · MCP: https://api.flicker.finance/mcp