Documentation API
Interrogez les jeux de données et observations datées avec une clé API de compte.
Authentification et accès
Envoyez la clé dans l’en-tête X-API-Key via HTTPS. Les jetons de connexion et clés d’ingestion ne conviennent pas. Ne mettez jamais la clé dans une URL ni en public.
Les abonnements ne sont pas encore en vente. L’évaluation est sur invitation, sans paiement.
Jeux de données et observations
Consultez d’abord le catalogue et utilisez un identifiant retourné. Les prix exigent frequency, startDate et endDate ; les commandes, startPeriod et endPeriod au format mensuel ou annuel d’origine.
Les unités, devises, régions, fréquences et bases statistiques sont conservées, sans interpolation, prix simulés ni conversion automatique.
Utilisez limit (1–1 000) et nextAfter comme prochain after, sans changer les filtres. Le curseur est exclusif ; une réponse vide n’est pas un prix nul.
Utilisation et erreurs
Les requêtes authentifiées admises comptent, même en erreur. Les lignes et observations retournées consomment le quota d’enregistrements, partagé entre clés et renouvelé au début du mois UTC.
400 : paramètres ; 401 : clé ; 403 : accès inactif ; 404 : aucun jeu publié ; 429 : limite ; 503 : évaluation désactivée. Retry-After de 60 s est une attente minimale, non une remise à zéro mensuelle.
Consultations GET uniquement, sans exécution d’ordres, conseil d’investissement ni exposition des comptes, brouillons ou dossiers administratifs.
GET /api/v1/datasets?limit=100 GET /api/v1/prices/{id}/observations?frequency=daily&startDate=2026-01-01&endDate=2026-01-31 GET /api/v1/ship-orders/{id}/observations?startPeriod=2025-01&endPeriod=2025-12 X-API-Key: YOUR_API_KEY