API EMpulse Street FX Index
Taux de change de rue quotidiens des devises des marchés émergents, cotés en monnaie fiat pour 1 USDT (l'USDT est assimilé à 1 USD) : le taux réellement payé, et non le taux officiel. Chaque série porte une classe de confiance. La méthode complète figure dans la méthodologie.
Champs d'une ligne de l'indice
| Champ | Signification | Quand il vaut null | Offre |
|---|---|---|---|
buy | Taux moyen pondéré du jour auquel un client achète des USDT contre de la monnaie fiat. | Le côté achat compte trop peu de points de données pour le jour. | Toutes les offres |
sell | La même chose pour le côté où le client vend des USDT. | Le côté vente compte trop peu de points de données pour le jour. | Toutes les offres |
mid | (buy + sell) / 2 lorsque les deux côtés existent ; lorsqu'un seul côté existe, le taux de ce côté. | Aucun des deux côtés n'a assez de points de données. | Toutes les offres |
side | Les côtés à partir desquels le mid est construit : both, buy ou sell. Un mid issu d'un seul côté est décalé d'environ la moitié d'un spread par rapport à un mid à deux côtés. | Il n'y a pas de mid. | Toutes les offres |
spread_pct | (buy − sell) / mid × 100. | Le côté n'est pas both. | Toutes les offres |
confidence | high, medium ou limited : la classe de la devise selon sa couverture ; un jour avec moins de points de données que d'habitude est classé un niveau plus bas. limited signifie moins de sources ou de points de données, donc plus de bruit et des lacunes possibles. | Jamais. | Toutes les offres |
flag | outlier pour un jour comptant peu de points de données dont le mid s'écarte de plus de 10% du mid médian des ±15 jours environnants. Un tel jour conserve ses valeurs mais est exclu de mid_7d et des champs chg_*. | Le jour n'est pas une valeur aberrante. | Toutes les offres |
in_progress | true pour le dernier jour d'une devise tant que la journée est en cours de collecte et que ses points de données sont nettement inférieurs à la norme des 7 jours précédents. | Jamais. | Toutes les offres |
mid_7d | Moyenne des mid valides sur les 7 derniers jours calendaires, jour courant inclus. | Il n'y a aucun mid valide dans la fenêtre. | Toutes les offres |
chg_1d_pct | Variation du mid par rapport à exactement 1 jour calendaire plus tôt, en pourcentage. | L'un des deux jours n'a pas de mid valide. | Toutes les offres |
chg_7d_pct | Variation du mid par rapport à exactement 7 jours calendaires plus tôt, en pourcentage. | L'un des deux jours n'a pas de mid valide. | Toutes les offres |
chg_30d_pct | Variation du mid par rapport à exactement 30 jours calendaires plus tôt, en pourcentage. | L'un des deux jours n'a pas de mid valide. | Toutes les offres |
exchange_spread_pct | Écart entre les bourses qui cotent la devise le jour considéré : (mid de bourse le plus haut − mid de bourse le plus bas) / médiane × 100. Un écart qui s'élargit est l'une des entrées de FX Stress Signals. | Moins de deux bourses cotent la devise, ou la clé est une clé gratuite. | Pro, Enterprise |
Les dates sont des jours calendaires UTC. Le dernier jour est incomplet tant qu'il n'est pas clos et peut être révisé ; les indicateurs des 15 derniers jours peuvent changer à mesure que de nouvelles données arrivent.
Taux horaires (Pro et Enterprise). GET /v1/rates/CUR/hourly?from=&to= renvoie l'indice par heure UTC (31 jours au maximum par requête), /v1/rates/CUR/hourly/latest les 24 dernières heures d'une série, /v1/rates/hourly/latest la dernière heure complète de chaque devise. Les lignes horaires comportent les mêmes champs buy, sell, mid, side, spread_pct, confidence et in_progress ; les réponses par devise ajoutent un summary par jour. Les clés gratuites reçoivent l'erreur 403 tier_not_in_plan.
Indice de rue multi-sources. /v1/street-index/* : taux de rue agrégés à partir de nombreuses sources de marché publiques indépendantes, avec un score de confiance, pour chaque devise couverte par les sources (même clé).
Envoyez votre clé dans l'en-tête X-API-Key. Free : RUB, UAH, EGP uniquement, 100 requêtes par jour, jusqu'au dernier jour complet. Pro : toutes les devises, 10,000 requêtes par jour, y compris le jour en cours (non terminé). Enterprise : selon contrat. Les limites sont réinitialisées à 00:00 UTC.
JSON par défaut ; envoyez Accept: text/csv ou ajoutez ?format=csv pour obtenir du CSV. Les erreurs sont renvoyées en JSON avec un objet error contenant un code et un message, avec le statut 400 (paramètres incorrects), 401 (clé absente ou invalide), 403 (période, devise ou produit non inclus dans l'offre : tier_delay, currency_not_in_plan, tier_not_in_plan, key_frozen), 404 (devise ou route inconnue), 429 (rate_limit_exceeded, history_quota_exceeded) ou 503.
Les lignes de plus de 90 jours sont décomptées d'un quota quotidien par clé (free 1,000, pro 3,000 lignes par jour UTC) ; des exports complets sont disponibles dans le cadre d'un contrat Enterprise. Les clés sont personnelles ; le téléchargement massif automatisé entraîne le gel de la clé. Consultez les conditions.
Les taux de rue ne sont pas des taux officiels ni interbancaires ; les séries dont la confidence est limited peuvent être bruitées et comporter des lacunes. Les données ne constituent pas un conseil en investissement.