Développeurs

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.

Spécifications et références

Document OpenAPI

Toute la surface de l'API, lisible par machine, en OpenAPI 3.1.

Référence interactive

Parcourez chaque point d'accès, schéma et exemple dans le navigateur.

Obtenir une clé API

Création, liste et révocation en libre-service, dans l'onglet des clés API.

Serveur MCP

Point d'accès, catalogue d'outils et configuration pour Claude, ChatGPT et Cursor.

Flux de versions

Historique des versions lisible par machine ; chaque entrée est étiquetée par plateforme, `api` comprise.

llms.txt

L'index sélectionné de ce site pour les modèles de langage.

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
Versions: /v1/ /v2/
OpenAPI: https://api.flicker.finance/docs/openapi.json

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.

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

Démarrage rapide

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

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 / 60s
Headers: x-ratelimit-limit x-ratelimit-remaining x-ratelimit-used x-ratelimit-window 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.

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

ErrorResponse · 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.

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.

https://api.flicker.finance/mcp

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.