Utilisez le paramètre Endpoint pour obtenir les devis pour un ou plusieurs paires de devises. Le cas échéant, le nombre de soumissions renvoyées est imputé sur la limite de cotation de votre régime. Vous pouvez demander des devis pour une seule date ou en moyenne sur une période. Si votre plan comporte une limite de cotation, chaque réponse inclura l'en tête restant de limite de taux X contenant le nombre de cotations restantes disponibles pour la période de facturation actuelle. Monnaie de base. La devise de base pour toutes les paires de devises dans le format de sortie de la requête Le format de sérialisation de la sortie Paramètres de requête d'entrée Tous les paramètres de requête sont facultatifs et la valeur par défaut de chacun est notée. (Chaîne) Un code de devise à 3 lettres en majuscules tel que défini par la valeur par défaut du point final de devises. Toutes les monnaies de devis disponibles (moins le: cours de base) telles que définies par le point de fin des devises Peut être spécifié plusieurs fois, c'est à dire v1ratesUSD. jsonquoteEURampquoteCHFampquoteGBP Ce paramètre contrôle le nombre de cotations qui sont imputées sur votre limite de devis. Chaque devise de devis renvoyée par l'API compte sur votre limite de cotation Notez que si vous ne spécifiez pas de paramètre de devis (c'est à dire l'option par défaut), des devis multiples sont retournés et comptés en fonction de votre exemple de limite de devis. Pour demander les derniers taux USDEUR et USDCAD, cliquez sur Curl X GET oandaratesapiv1ratesUSD. jsonquoteEURampquoteCAD champs Une liste de valeurs de devis pour renvoyer le format. (Chaîne) N'importe laquelle des moyennes. Milieu. Hauts Lows ou all Peut être spécifié plusieurs fois fieldsall est l'équivalent de fieldsaveragesampfieldsmidpointampfieldshighsampfieldslows moyennes. Si la période est un jour, il s'agit de la moyenne (moyenne) des enchères et des devis quotidiens de ce jour. Si la période est un intervalle de dates, il s'agit de la moyenne Moyenne (moyenne) des enchères et demander des devis sur cette période. La moyenne de la période est calculée à l'aide de la moyenne des enchères quotidiennes et de la moyenne des cotations. Le point milieu des enchères et des devis (point milieu) Dans une demande de plage de dates, il s'agit du point milieu entre les enchères moyennes de la période et les devis. REMARQUE . Le point milieu est toujours arrondi au même niveau de précision que les enchères et les devis. Ainsi, une demande de 1.7533 et une enchère de 1.7522 aurait un point médian de 1.7528 et non 1.75275 hauts. La soumission la plus élevée et la demande de la période (highbid et highask) Dans une demande de période, il s'agit de la plus élevée (maximum) highbid et de la highask sur cette gamme. Les enchères faibles et les devis de demande pour la période (lowbid et lowask) Dans une demande de plage de dates, ce sont les plus bas (minimum) lowbid et lowask quotes sur cette plage par défaut. Des moyennes par exemple. Demander les dernières moyennes et moyennes pour EURUSD curl X GET oandaratesapiv1ratesEUR. jsonquoteUSDampfieldsaveragesampfieldsmidpoint dataset Quel jeu de données au format de requête. (Chaîne) Soit oanda ou ecb oanda. L'original et par défaut OANDA taux ecb. Le défaut de taux de la Banque centrale européenne (BCE). Oanda REMARQUE. Le taux de la BCE se compose d'un taux au comptant unique. En tant que tel, le paramètre champs sera ignoré lorsque dataset est défini à l'exemple ecb. Demander la dernière courbe de taux de la BCE EURUSD X GET oandaratesapiv1ratesEUR. jsonquoteUSDampdatasetecb décimales Nombre de décimales à renvoyer dans le format de sortie de devis. (Entier) un entier de 1 à 15 ou toutes les paires de devises ont moins de décimales stockées que ce qui est demandé dans ce paramètre. Pour ces paires de devises, les guillemets retournés sont rembourrés avec des zéros pour correspondre au nombre de décimales requis. Vous pouvez demander le nombre maximum de décimales stockées pour une paire de devises en spécifiant tout. Si plusieurs devises sont demandées, la précision de chaque paire peut varier. défaut . 5 exemple. Demander la dernière cotation EURUSD arrondie à 4 décimales curl X GET oandaratesapiv1ratesUSD. jsonquoteEURampdecimalplaces4 date Un format de date de soumission spécifique. (Chaîne) Au format AAAA MM JJ Les mois et jours à chiffre unique doivent être spécifiés avec des zéros en tête Les dates sont dans le fuseau horaire UTC La date spécifiée doit être inférieure ou égale à la valeur par défaut de la date d'aujourd'hui. Le jour en cours (fuseau horaire UTC) REMARQUE: la spécification de la valeur par défaut ou la date d'aujourd'hui renvoie les dernières citations disponibles. Si les citations d'aujourd'hui existent, elles sont retournées, sinon l'API renvoie les dernières citations disponibles. Le paramètre date est ignoré si start et end sont utilisés pour demander un exemple de plage de dates. Demande EURUSD pour le 1er janvier 2014 curl X GET oandaratesapiv1ratesEUR. jsonquoteUSDampdate2014 01 01 début et fin Dates de début et de fin pour le calcul des cotations moyennes sur un format de période. (Chaîne) Au format AAAA MM JJ Les mois et jours à chiffre unique doivent être spécifiés avec des zéros avant Les dates sont dans le fuseau horaire UTC Doit être inférieur ou équivalent à la date d'aujourd'hui Si le début est spécifié mais non terminé. Alors end est supposé être le jour courant If end est spécifié mais ne démarre pas ou si start vient après fin. Une erreur est générée Les valeurs initiales et finales identiques sont équivalentes à une valeur de paramètre de date unique, le début et la fin ne peuvent pas être plus de trois mois d'intervalle par défaut. Aucune l'absence de début et de fin ou une valeur de date renvoie les dernières citations disponibles. Demandez la moyenne de l'enchère et demandez l'EURUSD pour le mois de janvier 2014 Curl X GET oandaratesapiv1ratesEUR. jsonquoteUSDampstart2014 01 01ampend2014 01 31 Consultez la section Intervalle de dates pour plus d'informations sur la façon dont les guillemets retournés diffèrent d'une demande de date régulière. Plan a une limite de quote, toutes les réponses du point de terminaison Rates incluront également l'en tête HTTP X Rate Limit Remaining. La valeur des en têtes est le nombre de guillemets restant pour la période de facturation actuelle. Cette valeur est également disponible à partir du point de terminaison Remaing Quotes. Les exemples suivants montrent la sortie pour une demande de tous les champs pour USDEUR et USDGBP pour le 1er janvier 2014. En têtes de réponse corps de l'ampli: Champs de réponse Remarque: La méta section n'est pas renvoyée dans le cadre des réponses CSV. Meta (JSONXML) Métadonnées sur la requête originale effectiveparams (JSONXML) Liste des paramètres de requêtes effectifs effectués après la normalisation de l'entrée et l'application des valeurs par défaut requesttime (JSONXML) La date et l'heure UTC de cette requête Ceci est utile pour signaler des problèmes à OANDA (JSONXML) La liste des monnaies qui ont été ignorées en raison de l'absence de données pour la date ou la tranche de date demandée (ALL) Le code de devise de base à trois caractères demandé (JSONXML) Le conteneur pour toutes les cotes renvoyées Par une devise de demande (XMLCSV) La monnaie de devis à trois caractères pour un devis dans le conteneur de devis (JSON) La devise est la clé de l'objet contenant la date de cotation (ALL) La date UTC et l'heure où cette citation a été générée NOTE. Certaines paires de devises, en particulier celles qui contiennent des devises exotiques ou émergentes, ne sont pas mises à jour quotidiennement. Pour les demandes contenant ces paires de devises, l'API renvoie la citation la plus récente. Cela peut entraîner la même citation retournée sur plusieurs jours consécutifs. (ALL) La moyenne (moyenne) des enchères et des devis sur le point de la date demandée (ALL) Le taux au comptant lors de l'utilisation de la base de données ECB milieu (ALL) Le point milieu entre la soumission et demander des citations highbid et highask Les enchères les plus élevées et les devis les plus demandées pour la date demandée lowbid et lowask (ALL) Les cotations les plus basses et les devis les plus demandées pour la date demandée Date Ranges Lorsqu'une plage de dates est spécifiée en commençant et en fin, Moyen) d'enchérir et de demander des devis sur la plage de dates. La moyenne de la période est calculée à l'aide de la cotation quotidienne moyenne de l'offre et de la demande sur l'ensemble de la période, y compris les dates de début et de fin. Pour la BCE uniquement. Le taux moyen (moyen) au comptant sur la période. Ceci est calculé comme l'offre et la demande sont. Point médian Le point médian entre la période moyenne de soumission et de demande de devis. Il ne s'agit pas de la moyenne de tous les points moyens highbid et highask Les valeurs les plus élevées (maximum) highbid et highask dans la gamme lowask et lowbid Les valeurs les plus basses (minimum) lowbid et lowask de la plage Attention Cette section aborde la façon dont l'API gère un nombre Des cas particuliers: taux de la Banque centrale européenne (BCE): toutes les monnaies ne sont pas disponibles en utilisant le taux de la BCE. Vérifiez le point de fin de devises avec datasetecb pour voir ce qui est disponible pour cet ensemble de données Le taux de la BCE se compose uniquement d'un prix au comptant. En tant que tel, l'option champs sera ignorée lors de la demande de taux de la BCE. Disponibilité des devis par date ou période: L'API renvoie des devis pour les paires de devises dont les données sont disponibles à cette date ou à cette période. Par exemple, si vous passez une date antérieure au 1er janvier 1999, l'API ne renverra aucune paire de devises EUR. Veuillez noter que les devis qui ne sont pas retournés par l'API ne sont pas comptés en fonction de votre limite de cotation. Par conséquent, une demande avec une date ou une plage de dates peut renvoyer un nombre de devis différent d'une autre date ou période. Vous pouvez supposer que vous ne renvoyerez pas plus de 200 guillemets par appel API Si votre demande d'API spécifie les champs hauts et bas (c. à d. Highbid, highask, lowbid, lowask): Ces champs ne sont disponibles que pour les instruments négociables sur OANDA fxTrade platform Si ces champs sont demandés et ne sont pas disponibles, ils sont omis dans les résultats. Si le format de sortie est JSON ou XML, les champs ne sont pas inclus dans la citation. Si le format de sortie est CSV, les colonnes correspondant à ces champs sont laissées vides. Seules les hautes et les basses sont demandées et il n'y a pas de devis pour une devise de devis particulière, la citation est omise dans la réponse. S'il n'y a pas de devis pour TOUTES devises de devis, l'API générera une réponse d'erreur si cela entraîne l'omission de toutes les citations, une date d'erreur est rejetée lorsqu'une période est demandée car les guillemets retournés sont calculés sur À la volée et non stockées par l'API Toutes les paires de devises ne sont pas mises à jour quotidiennement. Pour ces paires de devises, la demande d'une date particulière renvoie la citation la plus récente avant ce jour. Paramètres de requête d'entrée Endpoints d'entrée accountId: Obligatoire L'ID de compte pour récupérer la liste des instruments négociables pour. Champs: Facultatif Liste codée en URL (2C) séparée par des virgules des champs d'instruments qui doivent être retournés dans la réponse. Le champ de l'instrument sera renvoyé indépendamment de l'entrée de ce paramètre de requête. Veuillez consulter la section Paramètres de réponse ci dessous pour obtenir la liste des valeurs valides. Instruments: Facultatif Liste codée en URL (2C) séparée par des virgules d'instruments qui doivent être retournés dans la réponse. Si l'option instruments n'est pas spécifiée, tous les instruments seront retournés. Paramètres de réponse instrument: Nom de l'instrument. Cette valeur doit être utilisée pour récupérer les prix et créer des commandes et des transactions. DisplayName: Nom d'affichage de l'utilisateur final. MaxTradeUnits: Nombre maximum d'unités pouvant être échangées pour l'instrument. Précision: La plus petite unité de mesure pour exprimer le changement de valeur entre la paire d'instruments. MaxTrailingStop: La valeur de fin de traînée maximale (en pips) qui peut être définie lors de la négociation de l'instrument. MinTrailingStop: Valeur minimale de fin de traînée (en pips) qui peut être définie lors de la négociation de l'instrument. MarginRate: marge requise pour l'instrument. Un taux de marge de 3 sera représenté par 0,03. Stoppé: Le statut commercial actuel de l'instrument. Vrai si le négoce est arrêté, faux si trading est actif. Ce champ représente les mêmes informations renvoyées par le champ d'état dans le point de terminaison v1prices. InterestRate: le taux payé ou gagné en tenant la position de devise associée. La réponse est divisée en taux d'enchère et de demande pour les devises de base et de devis. Remarque . Un taux d'intérêt de 1,25 sera représenté par 0,0125. Pour plus d'informations sur les devises de basequote, voir ici. Pour plus d'informations sur la façon d'utiliser les taux d'intérêt, voir ici. Si le paramètre fields n'a pas été spécifié dans la requête, les champs d'instrument par défaut retournés sont instrument. Afficher un nom . Pip. MaxTradeUnits. Input Query Parameters instrument: Required Nom de l 'instrument pour l' extraction de l 'historique. L'instrument doit être l'un des instruments disponibles à partir de la granularité de réponse de v1instruments 1: Facultatif La plage de temps représentée par chaque chandelier. La valeur spécifiée déterminera l'alignement du premier chandelier. Les valeurs valides sont: Haut de l'alignement des minutes Haut de l'alignement des heures Alignement du début du jour (par défaut 17:00, TimezoneNew York) Alignement de début de semaine (par défaut vendredi) Alignement de début de mois (premier jour du mois) Par défaut pour granularité Est S5 si le paramètre de granularité n'est pas spécifié. Count: Facultatif Le nombre de bougies à retourner dans la réponse. Ce paramètre peut être ignoré par le serveur en fonction de la plage de temps fournie. Voir Time and Count Semantics ci dessous pour une description complète. Si ce paramètre n'est pas spécifié, la valeur par défaut est 500. La valeur maximale acceptable pour count est 5000. count ne doit pas être spécifié si les deux paramètres de début et de fin sont également spécifiés. Start 2: Facultatif L'horodatage de début de la plage de bougies demandée. La valeur spécifiée doit être dans un format datetime valide. End 2: Facultatif L'horodatage de fin pour la plage de bougies demandée. La valeur spécifiée doit être dans un format datetime valide. CandleFormat: Représentation facultative des chandeliers (sur la représentation du candéstick). Il peut s'agir de l'un des éléments suivants: point médian chandeliers à point milieu. Bidask BidAsk basé chandeliers La valeur par défaut de candleFormat est bidask si le paramètre candleFormat n'est pas spécifié. IncludeFirst: Facultatif Champ booléen qui peut être défini sur true ou false. Si elle est définie sur true, le chandelier couvert par l'horodatage de début sera retourné. Si elle est définie sur false, ce chandelier ne sera pas retourné. Ce champ existe afin que les clients puissent facilement s'assurer qu'ils peuvent sondage pour toutes les bougies plus récentes que leur dernière bougie reçue. La valeur par défaut de includeFirst est true si le paramètre includeFirst n'est pas spécifié. DailyAlignment: Facultatif L'heure utilisée pour aligner les bougies avec une granularité horaire, quotidienne, hebdomadaire ou mensuelle. La valeur spécifiée est interprétée comme une heure dans le fuseau horaire défini par le paramètre alignmentTimezone et doit être un entier compris entre 0 et 23. La valeur par défaut de dailyAlignment est 17, ce qui correspond à 17:00 heure locale à New York. AlignmentTimezone: Facultatif Le fuseau horaire à utiliser pour le paramètre dailyAlignment. Ce paramètre n'affecte PAS l'horodatage retourné, les paramètres de début ou de fin, ceux ci seront toujours en UTC. Le format de fuseau horaire utilisé est défini par la base de données IANA Time Zone. Une liste complète des fuseaux horaires pris en charge par l'API REST peut être trouvée ici. La valeur par défaut de alignmentTimezone est AmericaNewYork si le paramètre alignmentTimezone n'est pas spécifié. WeeklyAlignment: Facultatif Le jour de la semaine utilisé pour aligner les bougies avec granularité hebdomadaire. La valeur spécifiée sera utilisée comme jour startend lors du calcul des bougies hebdomadaires. Les valeurs valides sont: lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche. La valeur par défaut de weeklyAlignment est vendredi si le paramètre weeklyAlignment n'est pas spécifié. 1 Aucune bougie n'est publiée pour les intervalles où il n'y a pas de tiques. Cela entraînera des écarts entre les différentes périodes. 2 Si ni le début ni l'heure de fin ne sont spécifiés par le demandeur, end sera par défaut à l'heure actuelle et les bougies de comptage seront retournées.
No comments:
Post a Comment