DOF1 tokenPOST

Tipo de cambio e indicadores

Obtén los indicadores financieros oficiales publicados por el Diario Oficial de la Federación (DOF): tipo de cambio del dólar, valor de las UDIS, Costo de Captación a Plazo (CCP/CPP) y las distintas Tasas de Interés Interbancarias de Equilibrio (TIIE). Puedes consultar los indicadores del día, todos los indicadores de una fecha específica, o la serie histórica de un indicador entre dos fechas.

Endpoint

POSThttps://api.datosnonstop.com/v1/dof/tipo-cambio-indicadores

Parámetros

json

{
  "type": "daily"
}

ParámetroTipoRequeridoDescripción

typestringSíModo de consulta: daily (indicadores del día), date (todos los indicadores de una fecha) o indicator (serie histórica de un indicador entre dos fechas).

indicatorstringNoCódigo del indicador a consultar. Requerido cuando type es indicator.

startDatestringNoFecha inicial en formato YYYY-MM-DD. Requerida cuando type es date o indicator.

endDatestringNoFecha final en formato YYYY-MM-DD. Requerida cuando type es indicator; debe ser mayor o igual a startDate.

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/dof/tipo-cambio-indicadores \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"type":"daily"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "63b5c073cd0f651ec4322403",
  "status": "found",
  "indicadores": [
    {
      "codigo": 158,
      "indicador": "DOLAR",
      "fecha": "2024-05-03",
      "valor": "18.1052"
    },
    {
      "codigo": 159,
      "indicador": "UDIS",
      "fecha": "2024-05-03",
      "valor": "7.774167"
    },
    {
      "codigo": 165,
      "indicador": "TIIE 28 DIAS",
      "fecha": "2024-05-03",
      "valor": "11.4149%"
    }
  ]
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "startDate"
  },
  {
    "type": "catalog",
    "message": "El valor no existe en el catálogo",
    "field": "indicator"
  },
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "endDate"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

typestringModo de consulta. Ver catálogo Tipo de consulta.

indicatorstringCódigo del indicador a consultar. Requerido cuando type es indicator. Ver catálogo Indicadores.

startDatestringFecha inicial en formato YYYY-MM-DD (ISO 8601). Requerida cuando type es date o indicator.

endDatestringFecha final en formato YYYY-MM-DD (ISO 8601). Requerida cuando type es indicator; debe ser mayor o igual a startDate.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringResultado de la consulta. Ver catálogo Status.

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.

indicadoresarrayLista de indicadores encontrados. Solo está presente cuando status es found.

indicadores[].codigonumberCódigo del tipo de indicador reportado por el DOF. Ver catálogo Indicadores.

indicadores[].indicadorstringNombre descriptivo del indicador (p. ej. DOLAR, UDIS, TIIE 28 DIAS).

indicadores[].fechastringFecha de publicación del valor en formato YYYY-MM-DD.

indicadores[].valorstringValor publicado por el DOF. Se devuelve como cadena; las tasas de interés incluyen el sufijo de porcentaje (p. ej. "11.4149%").

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

foundSe encontraron indicadores para los parámetros enviados. La respuesta incluye el arreglo indicadores.

not_foundNo se encontró información para los parámetros enviados. La respuesta incluye el campo message con el detalle.

Tipo de consulta

Valores posibles del parámetro type y los campos que requiere cada uno.

ValorDescripción

dailyDevuelve los indicadores publicados el día más reciente. No requiere parámetros adicionales.

dateDevuelve todos los indicadores de una fecha específica. Requiere startDate.

indicatorDevuelve la serie histórica de un indicador entre dos fechas. Requiere indicator, startDate y endDate.

Indicadores

Códigos de indicador válidos para el parámetro indicator y el campo codigo de la respuesta.

CódigoIndicador

158DOLAR

159UDIS

160CCP

161CCP-UDIS

162CPP

163CCP-DOLARES

165TIIE 28 DIAS

166TIIE 91 DIAS

167TIIC

168TIIC

169TIIC

170TIIC

171TIIC

172TIIC

174TIIE 182 DIAS

175TIIE DE FONDEO

176TIIE 90 DIAS

177TIIE 29 DIAS

178TIIE 27 DIAS

179TIIE 26 DIAS

180TIIE 181 DIAS

181TIIE 92 DIAS

182TIIE 89 DIAS

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/dof/tipo-cambio-indicadores

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/dof/tipo-cambio-indicadores \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"type":"daily"}'

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de daily.

CasoCampotype

Caso exitoso — Encontradotypedaily

No encontradostartDate2000-01-01

Sin tokensstartDate2000-01-02

Error internostartDate2000-01-03

Unavailable servicestartDate2000-01-04

Empezar gratis →