Use o ponto final Taxas para obter as cotações de um ou mais pares de moedas. Se aplicável, o número de cotações devolvidas é cobrado em relação ao limite de cotação para seu plano. Você pode solicitar cotações para uma única data, ou como uma média em um intervalo de datas. Se o seu plano tiver um limite de cotação, cada resposta incluirá o cabeçalho restante de restrição de X que contém o número de cotações restantes disponíveis para o período de faturamento atual. moeda base. A moeda base para todos os pares de moedas no formato de saída da solicitação O formato de serialização da saída Parâmetros da consulta de entrada Todos os parâmetros da consulta são opcionais e o padrão para cada uma das cotações é citada. Uma moeda de cotação para cruzar com o formato: basecurrency. (String) Um código de moeda em letras maiúsculas e minúsculas, conforme definido pelo padrão padrão do nó de extremidade. Todas as moedas de cotação disponíveis (menos a base de dados), conforme definido pelo ponto de referência de Moedas. Pode ser especificado várias vezes, exceto v1ratesUSD. jsonquoteEURampquoteCHFampquoteGBP. Este parâmetro controla o número de cotações que são cobradas contra o limite de cotação. Cada moeda de cotação retornada pelas contagens de API em relação ao limite de cotação. Observe que, se você não especificar um parâmetro de cotação (ou seja, a opção padrão), as cotações múltiplas são retornadas e contadas em relação ao exemplo de limite de cotação. Para solicitar as últimas taxas USDEUR e USDCAD curl - X GET oandaratesapiv1ratesUSD. jsonquoteEspañolCAD campos Uma lista de valores de cotações para retornar o formato. (String) Qualquer uma das médias. Ponto médio. Altos. Mínimos ou todos podem ser especificados várias vezes fieldsall é o equivalente a fieldsaveragesampfieldsmidpointampfieldshighsampfieldslows médias. A média (média) e solicita cotações para o período (lance e perguntar) Se o período for de um dia, estes são o lance diário médio (médio) e pergunte as cotações nesse dia. Se o período for um intervalo de datas, estes são os Oferta média (média) e solicite cotações durante esse intervalo de datas. A média da faixa de data é calculada usando a oferta diária média e pergunta o ponto intermediário das cotações. O ponto médio das cotações de oferta e pedido (ponto médio) Em uma solicitação de intervalo de datas, este é o ponto médio entre o lance médio do intervalo de datas e as cotações. NOTA . O ponto médio é sempre arredondado para o mesmo nível de precisão que as cotações de ofertas e pedidos. Assim, uma pergunta de 1.7533 e uma oferta de 1.7522 teria um ponto médio de 1.7528 e não de 1.75275. A oferta alta e solicita o período (highbid e highask) Em uma solicitação de intervalo de data, estes são os mais altos (máximos) highbid e highask sobre esses limites de intervalo. As cotações baixas de oferta e solicitação para o período (lowbid e lowask) Em uma solicitação de intervalo de datas, essas são as cotações lowbid e lowask mais baixas (mínimas) sobre esse padrão de intervalo. Exemplo de médias. Solicite as mais recentes médias e pontos médios para EURUSD curl - X GET oandaratesapiv1ratesEUR. jsonquoteUSDampfieldsaveragesampfieldsmidpoint dataset Qual conjunto de dados para o formato de consulta. (String) Ou oanda ou ecb oanda. A taxa OANDA original e padrão de ecb. A taxa padrão do Banco Central Europeu (BCE). Oanda NOTA. A taxa do BCE consiste em uma taxa única. Como tal, o parâmetro de campos será ignorado quando o conjunto de dados estiver configurado para o exemplo do ecb. Solicite a última taxa de EURUSD ECB curl - X GET oandaratesapiv1ratesEUR. jsonquoteUSDampdatasetecb decimalplaces Número de casas decimais para retornar no formato de saída da citação. (Cordão inteiro) um número inteiro de 1 a 15 ou todos. Alguns pares de moedas possuem menos casas decimais armazenadas do que o solicitado neste parâmetro. Para esses pares de moedas, as cotações retornadas são preenchidas com zero para coincidir com o número de casas decimais solicitadas. Você pode solicitar o número máximo de casas decimais armazenadas para um par de moedas, especificando tudo. Se for solicitada múltiplas moedas de cotação, a precisão para cada par pode variar. padrão . 5 exemplo. Solicite a mais recente cotação EURUSD arredondada para 4 casas decimais curvilíneas - X GET oandaratesapiv1ratesUSD. jsonquotePapitípico local4 data Um formato específico da data de cotação. (String) No formato AAAA-MM-DD Simples dígitos meses e dias devem ser especificados com zeros iniciais As datas estão no fuso horário UTC A data especificada deve ser menor ou equivalente à data padrão da data de hoje. O dia atual (fuso horário UTC) NOTA: Especificar o valor padrão ou a data de hoje retorna as últimas cotações disponíveis. Se as cotações de hoje existem, elas são retornadas, caso contrário, a API retorna as últimas cotações disponíveis. O parâmetro da data é ignorado se o início e o fim são usados para solicitar um exemplo de intervalo de datas. Solicite EURUSD para 01 de janeiro de 2014 curl - X GET oandaratesapiv1ratesEUR. jsonquoteUSDampdate2014-01-01 iniciar e finalizar as datas de início e término para calcular as cotações médias em um formato de intervalo de datas. (String) No formato YYYY-MM-DD Simples dígitos meses e dias devem ser especificados com zeros principais As datas estão em fuso horário UTC Deve ser menor ou equivalente à data de hoje Se o início for especificado, mas não o fim. Então o fim é assumido como o dia atual Se o final for especificado, mas não o início ou se o começo for depois do fim. Um erro é gerado Os valores iniciais e finais idênticos são equivalentes a um único valor do parâmetro da data, o início e o final não podem ter mais de três meses de antecedência. Nenhuma a ausência de início e fim ou valores de data retorna o exemplo disponível nas últimas cotações. Solicite a oferta média e peça EURUSD para o mês de janeiro de 2014 curl - X GET oandaratesapiv1ratesEUR. jsonquoteUSDampstart2014-01-01ampend2014-01-31 Consulte a seção Intervalos de data para obter informações sobre como as cotações retornadas diferem de uma solicitação de data regular Se o seu Plano tem um limite de cotação, todas as respostas do ponto final de Taxas também incluirão o cabeçalho HTTP Restante-Limit-Remaining. O valor dos cabeçalhos é o número de cotações restantes para o período de faturamento atual. Esse valor também está disponível no parâmetro Remaing Quotes. Os exemplos a seguir mostram a saída para um pedido de todos os campos para USDEUR e USDGBP para 1 de janeiro de 2014. Cabeças de resposta corpo do amplificador: Campos de resposta Nota: A meta-seção não é retornada como parte das respostas CSV. Meta (JSONXML) Metadados na versão original do pedido de efetivos (JSONXML) Uma lista dos parâmetros de consulta efetivos feitos depois de normalizar a entrada e aplicar o tempo de solicitação por defeito (JSONXML) A data e a hora UTC que esta solicitação foi feita. Isso é útil ao relatar problemas a OANDA Sobre a disponibilidade de dados de suspensões ignoradas (JSONXML) Uma lista de moedas que foram ignoradas devido à ausência de dados para a data solicitada ou intervalo de datas (ALL) O código de moeda base de três caracteres citações solicitadas (JSONXML) O contêiner para todas as cotações retornou Por uma moeda de solicitação (XMLCSV) A moeda de cotação de três personagens para uma cotação no recipiente de cotações (JSON) A moeda é a chave para o objeto que contém a data de cotação (ALL) A data e hora UTC em que essa cotação foi gerada NOTA. Certos pares de moedas, especialmente aqueles que contém moedas exóticas ou emergentes, não atualizam diariamente. Para pedidos contendo esses pares de moedas, a API retorna a citação mais recente. Isso pode resultar na devolução da mesma cotação em vários dias consecutivos. Lance e peça (ALL) A média (média) de oferta e solicita cotações no ponto da data solicitada (ALL) A taxa spot ao usar o ponto intermediário do banco de dados do ECB (ALL) O ponto médio entre as cotações de lances e pedidos highbid e highask (ALL) The Oferta mais alta e solicite cotações para a data solicitada baixas e baixas (ALL) As cotações mais baixas e perguntam para a data solicitada Faixas de data Quando um intervalo de datas é especificado usando iniciar e encerrar as cotações retornadas são ligeiramente diferentes: lance e peça A média ( Significa) lance e peça citações durante o intervalo de datas. A média da faixa de data é calculada usando a oferta média diária e solicita alocações durante todo o intervalo de datas, incluindo o ponto de início e término apenas para o BCE. A taxa média média (média) em relação ao intervalo de datas. Isso é calculado apenas como lance e peça. Ponto médio O ponto médio entre o lance médio do intervalo de datas e as cotações. Não é a média de todos os midpoints highbid e highask Os valores highbid e highask mais altos (no máximo) no intervalo lowask e lowbid O menor (mínimo) valores lowbid e lowask no intervalo Restrições de amplificador de advertências Esta seção discute como a API lida com um número De casos especiais: taxas do Banco Central Europeu (BCE): nem todas as moedas estão disponíveis quando se utiliza a taxa do BCE. Verifique o ponto final de Moedas com datasetecb para ver o que está disponível para este conjunto de dados. A taxa do ECB consiste unicamente no preço à vista. Como tal, a opção de campos será ignorada ao solicitar taxas de ECB. Disponibilidade de cotações por data ou intervalo de datas: a API retornará cotações apenas para os pares de moedas que possuem dados disponíveis nessa data ou intervalo de datas. Por exemplo, se você passar uma data antes de 1º de janeiro de 1999, a API não retornará nenhum par de dólares em euros. Observe que as cotações que não são devolvidas pela API não são contadas em relação ao limite da citação. Por isso, um pedido com uma data ou intervalo de datas pode retornar um número diferente de cotações do que outra data ou intervalo de datas. Você pode assumir que não mais do que cerca de 200 cotações serão devolvidas por chamada de API Se sua solicitação de API especifica os campos de alta e baixa (ou seja, highbid. Highask. Lowbid. Lowask): esses campos estão disponíveis apenas para instrumentos que operam na plataforma OANDAs fxTrade Se esses campos forem solicitados e não estiverem disponíveis, eles serão omitidos dos resultados. Se o formato de saída for JSON ou XML, os campos não estão incluídos na citação. Se o formato de saída for CSV, as colunas correspondentes a esses campos ficam vazias. Se apenas são necessários altos e baixos, e não há cotações para uma moeda de cotação particular, a citação é omitida na resposta. Se não houver cotações para TODAS as moedas de cotação, a API gerará uma resposta de erro se isso resultar em todas as citações que foram omitidas, uma data errada é omitida de uma resposta de cotação quando um intervalo de datas é solicitado à medida que as cotações retornadas são calculadas em - the-fly e não armazenado pela API Nem todos os pares de moedas são atualizados diariamente. Para aqueles pares de moedas, solicitar uma cotação de datas específicas retorna a citação mais recente antes desse dia. Endereços de entrada. Parâmetro de consulta de entrada. Conta: Obrigatório O ID da conta para buscar a lista de instrumentos negociáveis. Campos: Opcional Uma URL codificada (2C) lista separada por vírgula de campos de instrumento que devem ser retornados na resposta. O campo do instrumento será retornado independentemente da entrada para este parâmetro de consulta. Consulte a seção Parâmetros de resposta abaixo para obter uma lista de valores válidos. Instrumentos: Opcional Uma lista de instrumentos com URL com codificação de URL (2C) separada que deve ser retornada na resposta. Se a opção de instrumentos não for especificada, todos os instrumentos serão devolvidos. Instrumento de parâmetros de resposta: Nome do instrumento. Esse valor deve ser usado para buscar preços e criar pedidos e negócios. DisplayName: Nome para o usuário final. MaxTradeUnits: o número máximo de unidades que podem ser negociadas para o instrumento. Precisão: a menor unidade de medida para expressar a mudança de valor entre o par de instrumentos. MaxTrailingStop: o valor de parada final máximo (em pips) que pode ser configurado ao trocar o instrumento. MinTrailingStop: o valor de parada final mínimo (em pips) que pode ser configurado ao trocar o instrumento. MarginRate: o requisito de margem para o instrumento. Uma taxa de 3 margens será representada como 0,03. Parou: o status comercial atual do instrumento. Verdadeiro se a negociação for interrompida, falso se a negociação estiver ativa. Este campo representa a mesma informação retornada pelo campo de status no ponto final v1prices. InterestRate: a taxa paga ou ganho ao manter a posição de moeda associada. A resposta é dividida nas taxas de lances e pedidos para as moedas de base e de cotação. Nota . Uma taxa de juros de 1,25 será representada como 0,0125. Para obter mais informações sobre as moedas da basequote, veja aqui. Para obter informações sobre como usar as taxas de juros, veja aqui. Se o parâmetro dos campos não foi especificado na solicitação, os campos de instrumento padrão retornados são instrumentos. Mostrar nome . Pip. MaxTradeUnits. Instrumento de parâmetros de consulta de entrada: Obrigatório Nome do instrumento para recuperar histórico para. O instrumento deve ser um dos instrumentos disponíveis da granularidade de resposta v1instruments 1: Opcional O intervalo de tempo representado por cada castiçal. O valor especificado determinará o alinhamento do primeiro castiçal. Os valores válidos são: Alinhamento superior do minuto Alinhamento superior da hora Alinhamento do início do dia (padrão 17:00, TimezoneNew York) Início do alinhamento da semana (sexta-feira padrão) Alinhamento do início do mês (Primeiro dia do mês) O padrão para granularidade É S5 se o parâmetro de granularidade não for especificado. Contagem: Opcional O número de velas para retornar na resposta. Este parâmetro pode ser ignorado pelo servidor, dependendo do intervalo de tempo fornecido. Veja Time and Count Semantics abaixo para obter uma descrição completa. Se não for especificado, a contagem será padrão para 500. O valor máximo aceitável para a contagem é 5000. a contagem não deve ser especificada se ambos os parâmetros de início e final também são especificados. Iniciar 2: Opcional O timestamp de início para o intervalo de velas solicitado. O valor especificado deve estar em um formato de data e hora válido. Final 2: Opcional O timestamp de fim para o intervalo de velas solicitado. O valor especificado deve estar em um formato de data e hora válido. CandleFormat: representação opcional de castiçais (sobre a representação do candelabro). Este pode ser um dos seguintes: ponto médio - castiçais baseados em pontos médios. Bidask - Candelabros baseados em BidAsk O padrão para CandleFormat é bidask se o parâmetro CandleFormat não for especificado. IncludeFirst: Opcional Um campo booleano que pode ser definido como verdadeiro ou falso. Se estiver definido como verdadeiro, o castiçal coberto pelo timestamp de início será retornado. Se estiver configurado como falso, este castiçal não será retornado. Este campo existe para que os clientes possam facilmente garantir que possam pesquisar todas as velas mais recentes do que a última vela recebida. O padrão para includeFirst é verdadeiro se o parâmetro includeFirst não for especificado. DailyAlignment: Opcional A hora do dia usada para alinhar velas com granularidade por hora, diária, semanal ou mensal. O valor especificado é interpretado como uma hora no fuso horário definido pelo parâmetro alignmentTimezone e deve ser um número inteiro entre 0 e 23. O padrão para dailyAlignment é 17, o que corresponde às 17:00 hora local em Nova York. AlinhamentoTimezone: Opcional O fuso horário a ser usado para o parâmetro dailyAlignment. Este parâmetro NÃO afeta o timestamp retornado, os parâmetros de início ou final, estes serão sempre em UTC. O formato do fuso horário utilizado é definido pelo banco de dados da zona horária da IANA. Uma lista completa dos fusos horários suportados pela API REST pode ser encontrada aqui. O padrão para alignmentTimezone é AmericaNewYork se o parâmetro alignmentTimezone não for especificado. WeekAlignment: Opcional O dia da semana usado para alinhar velas com granularidade semanal. O valor especificado será usado como o dia de início ao calcular as velas semanais. Valores válidos são: segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira, sábado e domingo. O padrão para WeekAlignment é sexta-feira se o parâmetro weeklyAlignment não for especificado. 1 Não são publicadas velas para intervalos em que não há carrapatos. Isso resultará em lacunas entre períodos de tempo. 2 Se nem o início nem o fim da hora forem especificados pelo solicitante, o final será padrão para a hora atual e as velas de contagem serão retornadas.
No comments:
Post a Comment