Usted está en: Portada > Documentación

Documentación .v3: Dólar de EE.UU.

El recurso Dólar de EE.UU. permite acceder a la información almacenada en la base de datos del sitio web institucional, la cual es recopilada para ser usada en diferentes aplicaciones.

Características Generales

El valor del Dólar que se entrega mediante la API corresponde al Dólar Observado que es calculado para cada día hábil por el Banco Central de Chile (Compendio de Normas de Cambios Internacionales del Banco Central y Capítulo II.B.3 del Compendio de Normas Financieras).

Uso de parámetros GET

La API fue implementada para que las URIs puedan ser utilizadas mediante parámetros GET, con el objetivo de indicar las características de la petición que se ejecuta. El orden en que se indiquen estos parámetros no es relevante.

Los parámetros utilizados en el API CMF Bancos son los siguientes:

  • apikey: permite incluir el valor de la clave se haya entregado al usuario.
  • formato: permite indicar si el archivo de salida será en formato JSON o XML; si no se utiliza este parámetro, la salida será en XML. Los parámetros se pueden indicar en mayúsculas (JSON|XML) o en minúsculas (json|xml).
  • callback: este parámetro es opcional y sólo se emplea cuando se pide un archivo de salida del tipo JSON (para obtener la respuesta usando JSONP). En caso de solicitarse una salida JSON y no especificarse una función de callback, se retorna JSON normal.

En cada uno de los recursos que se detallan en esta documentación se explica de manera más específica la forma de incluirlos.

Uso de parámetros generales en las URIs

Las URIS deben incluir la fecha en su contenido, por lo que se debe escribir el año, el mes y el día, si corresponde, para obtener la información. En cada caso, la inclusión se hace de la siguiente manera:

  • Year: se deben incluir cuatro números del año en el formato AAAA
  • Month: se deben incluir dos números del mes en el formato MM
  • Day: se deben incluir dos números del día en el formato DD

Códigos de Error

Cualquier llamado a los recursos que no cumpla con la entrega de la API Key o que tenga parámetros errados, generá un código de error con información general con la numeración usada en el protocolo HTTP y con información particular, de acuerdo a la nomenclatura utlizada en la API SBIF. En cualquier caso, un error generá un archivo XML con la información correspondiente.

Recursos disponibles

Los recursos disponibles para el Dólar de EE.UU. son los siguientes:

Dólar del día actual:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para el día actual.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para el día actual.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>505,70</Valor>
      <Fecha>2010-01-05</Fecha>
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de un año específico:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para cada día del año que se indique.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/<year>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/2010?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para cada día del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>505,70</Valor>
      <Fecha>2010-01-05</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de un mes de un año específico:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para cada día del mes del año que se indique.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/<year>/<month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/2010/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para cada día del mes de enero del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>505,70</Valor>
      <Fecha>2010-01-05</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de una fecha específica:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para una fecha específica.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/<year>/<month>/dias/<day>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/2010/01/dias/05?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para el día 5 del mes de enero del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>505,70</Valor>
      <Fecha>2010-01-05</Fecha>
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de fechas posteriores a un año:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para los años siguientes al año que se indique.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/posteriores/<year>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/posteriores/2009?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para las fechas posteriores al mes de diciembre del año 2009, es decir, desde enero de 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>507,10</Valor>
      <Fecha>2010-01-04</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de fechas posteriores a un mes de un año específico:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para una fecha posterior al mes y año que se indique en los parámetros.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/posteriores/<year>/<month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/posteriores/2010/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para las fechas posteriores al mes de enero del año 2010, es decir, desde febrero de 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>523,10</Valor>
      <Fecha>2010-02-01</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de fechas posteriores a una fecha:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para las fechas posteriores al mes, año y día que se indique.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/posteriores/<year>/<month>/dias/<day>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/posteriores/2010/01/dias/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para las fechas posteriores al 1 de enero del año 2010, es decir, desde el lunes 4 de enero de 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>507,10</Valor>
      <Fecha>2010-01-04</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de fechas anteriores a un año:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para las fechas anteriores al año que se indique en los parámetros.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/anteriores/<year>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/anteriores/2009?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para las fechas anteriores al 1 de enero del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>636,45</Valor>
      <Fecha>2009-01-02</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de días anteriores a un mes y año:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para las fechas anteriores al mes y año que se indique en los parámetros.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/anteriores/<year>/<month>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/anteriores/2010/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para las fechas anteriores al 1 de enero del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>636,45</Valor>
      <Fecha>2009-01-02</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de días anteriores a una fecha específica:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para las fechas anteriores al día, mes y año que se indique en los parámetros.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/anteriores/<year>/<month>/dias/<day>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/anteriores/2010/01/dias/01?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para las fechas anteriores al 1 de enero del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>636,45</Valor>
      <Fecha>2009-01-02</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de un período definido por dos fechas:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para las fechas que se indiquen, ambas incluidas.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/periodo/<year>/<month>/dias_i/<day>/<year2>/<month2>/dias_f/<day2>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/periodo/2010/01/dias_i/04/2010/01/dias_f/05?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para los días entre el 4 y 5 de enero del año 2010. El día de la fecha inicial es la que va después del parámetro /dias_i/ y el día final, es el que se indica tras el parámetro /dias_f/.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>507,10</Valor>
      <Fecha>2010-01-04</Fecha>
      </Dolar>
      <Dolar>
      <Valor>505,70</Valor>
      <Fecha>2010-01-05</Fecha>
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de un período definido por dos meses:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para cada uno de los días dentro de los meses y años que se indiquen en los parámetros.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/periodo/<year>/<month>/<year2>/<month2>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/periodo/2010/01/2010/03?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para cada uno de los días de los meses entre enero y marzo del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>507,10</Valor>
      <Fecha>2010-01-04</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>
Dólar de un período definido por dos años:

Descripción: Permite obtener un listado en xml o json con el valor del Dólar EE.UU. para cada uno de los días incluidos dentro de los años que se indiquen en los parámetros.

Autentificación: Al hacer la consulta se debe entregar la API Key junto con los argumentos.

Input: https://api.sbif.cl/api-sbifv3/recursos_api/<Dolar|dolar>/periodo/<year>/<year2>?apikey=<api_key>&formato=<json|JSON|xml|XML>&callback=<funcion_de_callback>

Ejemplo: https://api.sbif.cl/api-sbifv3/recursos_api/dolar/periodo/2009/2010?apikey=SBIF9990SBIF44b7SBIF7f4c5a537d02358e1099&formato=xml

Resultado: Entrega un archivo en formato xml con el valor del Dólar EE.UU. para cada uno de los días que van desde el 1 enero de 2009 y el 31 de diciembre del año 2010.

  • Ejemplo de Código de Resultado
    • <IndicadoresFinancieros xsi:schemaLocation="https://api.sbif.cl/XMLSchema IndicadoresFinancieros-v1.0.xsd" SchemaVersion="1.0">
      <...>
      <Dolares>
      <Dolar>
      <Valor>636,45</Valor>
      <Fecha>2009-01-02</Fecha>
      </Dolar>
      <Dolar>
      .
      .
      .
      </Dolar>
      </Dolares>
      <...>
      </IndicadoresFinancieros>

Actualizado: 06/02/2020