Si tu veux garder les requêtes dans ta propre infrastructure, fais tourner une instance privée avec l'image officielle sur Docker Hub. L'image est multi-plateforme et tourne sur amd64 comme sur arm64.

Démarrage rapide

Le plus rapide pour démarrer :

docker run -d --init -p 8080:8080 lineofflight/frankfurter

Frankfurter démarre sur le port 8080 avec une base de données éphémère. Certains endpoints peuvent renvoyer des données vides tant que le backfill initial n'est pas terminé.

Production

En production, monte un volume pour que la base SQLite survive aux redémarrages du conteneur :

docker run -d --init -p 8080:8080 \
  -e DATABASE_URL="sqlite:///data/db.sqlite3" \
  -v ./data:/data \
  --pull always \
  lineofflight/frankfurter

Sans volume monté, la base est éphémère et se reconstruit à chaque redémarrage.

Avec --pull always, Docker récupère la dernière image à chaque lancement.

Clés API

Certaines sources de données demandent une clé API. Toutes sont gratuites et facultatives.

docker run -d --init -p 8080:8080 \
  -e DATABASE_URL="sqlite:///data/db.sqlite3" \
  -e BAM_API_KEY="your_key" \
  -e BANXICO_API_KEY="your_key" \
  -e BCCH_USER="your_email" \
  -e BCCH_PASS="your_password" \
  -e BOT_API_KEY="your_key" \
  -e FRED_API_KEY="your_key" \
  -e TCMB_API_KEY="your_key" \
  -v ./data:/data \
  --pull always \
  lineofflight/frankfurter

BAM_API_KEY

Données de Bank Al-Maghrib. Inscription sur apihelpdesk.centralbankofmorocco.ma.

BANXICO_API_KEY

Données de Banco de México. Inscription sur banxico.org.mx.

BCCH_USER et BCCH_PASS

Données de Banco Central de Chile. Inscription sur bcentral.cl.

BOT_API_KEY

Données de Bank of Thailand. Inscription sur gateway.api.bot.or.th.

FRED_API_KEY

Données de la Réserve fédérale. Inscription sur fred.stlouisfed.org.

TCMB_API_KEY

Données de la Banque centrale de Turquie. Inscription sur evds3.tcmb.gov.tr.