search

fcoagz / api-pydolarvenezuela

La API de pyDolarVenezuela permite obtener información actualizada sobre el precio del dólar y euro de diversos monitores en Venezuela.
https://docs.pydolarve.org/
Apache License 2.0
137 stars 17 forks source link
api api-server bcv dolar-cotizacion dollar history-data monitor pages pydolarvenezuela python venezuela

readme

pyDolarVenezuela API

La API de pyDolarVenezuela es una herramienta eficiente y confiable que brinda información en tiempo real sobre el valor del dólar y euro en Venezuela. Además, facilita la conversión precisa entre bolívares y estas monedas extranjeras.

Swagger API: https://pydolarve.org/apidocs

URL base

https://pydolarve.org/

Endpoints

GET /

Este endpoint muestra un mensaje de bienvenida y proporciona un enlace a la documentación de la API.

GET /api/v1/<currency>

Este endpoint permite obtener todas las entidades de seguimiento del dólar y/o euro, junto con su nombre correspondiente, cambio y fecha de la última actualización. Ademas permite obtener información sobre el monitor en una página específica.

Las páginas disponibles son:

Página web Ruta
Banco Central de Venezuela api/v1/dollar?page=bcv
EnParaleloVzla api/v1/dollar?page=enparalelovzla
Italcambio api/v1/dollar?page=italcambio
Página web Ruta
AlCambio api/v1/dollar?page=alcambio
Criptodolar api/v1/<currency>?page=criptodolar
Dolartodayn api/v1/dollar?page=dolartoday

Ruta:

Parámetros Tipo Descripción
page string Opcional. Indica el nombre de la página donde deseas obtener su valor.
monitor string Opcional. Indica el monitor específico.
format_date string Opcional. Indica el tipo de formato de fecha. (iso, timestamp, default)

El parámetro format_date permite obtener la fecha en diferentes formatos. Por defecto, la fecha se muestra en formato DD/MM/YYYY, HH:mm AM/PM. Si deseas obtener la fecha en formato ISO o timestamp, puedes especificarlo en el parámetro format_date.

GET /api/v1/<currency>/history

Este endpoint le permite conocer el historial de precios de un monitor especificando la fecha de inicio y finalización.

Ruta:

Header:

Parámetros Tipo Descripción
page string Indica el nombre de la página donde deseas obtener su valor.
monitor string Indica el monitor específico.
start_date string Fecha de inicio del historial. DD-MM-YYYY
end_date string Fecha de fin del historial. DD-MM-YYYY
format_date string Opcional. Indica el tipo de formato de fecha. (iso, timestamp, default)

GET /api/v1/<currency>/changes

Este endpoint permite conocer los cambios que ha obtenido el monitor en un día concreto. (Actualizaciones de precios)

Ruta:

Header:

Parámetros Tipo Descripción
page string Indica el nombre de la página donde deseas obtener su valor.
monitor string Indica el monitor específico.
date string Fecha de la cual se desea obtener los precios. DD-MM-YYYY
format_date string Opcional. Indica el tipo de formato de fecha. (iso, timestamp, default)

GET /api/v1/<currency>/conversion

Este endpoint convierte un valor en bolívares a su equivalente a estas monedas extranjeras y viceversa.

Ruta:

Parámetros Tipo Descripción
type string Indica el tipo de conversión. Puede ser VES o USD o EUR.
value float or integer Indica el valor a convertir.
page string Indica el nombre de la página donde deseas obtener su valor.
monitor string Indica el monitor específico.

Webhooks

La API de pyDolarVenezuela también permite configurar webhooks para recibir notificaciones en tiempo real sobre los cambios de precios de los monitores. Para ello, debes proporcionar la URL de tu servidor y el token de autorización correspondiente.

GET /api/user/get-webhook

Este endpoint permite obtener todos los webhooks configurados por el usuario.

Header:

POST /api/user/set-webhook

Este endpoint permite configurar un webhook para recibir notificaciones en tiempo real sobre los cambios de precios de los monitores.

Header:

El token_secret es una clave secreta que se utilizará para verificar la autenticidad de las solicitudes entrantes. Y sera enviado en el header Authorization como Bearer <token_secret>.

Body:

{
  "url": "string",
  "certificate_ssl": true,
  "token_secret": "string",
  "monitors": [
    {
      "page": "string",
      "currency": "string", // dollar or euro
      "monitor": "string"
    }
  ]
}

[!NOTE] Una vez configurado el webhook, el servidor enviará una solicitud POST a la URL proporcionada cada vez que se produzca un cambio, despues de 3 intentos fallidos su estado pasará a false.

DELETE /api/user/del-webhook

Este endpoint permite eliminar un webhook configurado previamente.

Header:

Actividad

Alt

Uso

Para obtener información actualizada sobre el precio del dólar en Venezuela de EnParaleloVzla, puedes hacer una solicitud GET a la siguiente URL:

curl -X GET "https://pydolarve.org/api/v1/dollar?monitor=enparalelovzla"

Para obtener información sobre el dólar en una página específica, puedes hacer una solicitud GET a la siguiente URL:

curl -X GET "https://pydolarve.org/api/v1/dollar?page=bcv"

Sponsors

Individual Sponsors


José Gregorio
Bryan
Victor Noguera

Apoya este proyecto

Si deseas conocer características interesantes de la API de por vida, considera hacer una donación o suscribirte a través de Ko-fi. Tu apoyo contribuirá al continuo desarrollo del proyecto y al mantenimiento de los servicios en los que está alojado.

Características Gratis Token
Solicitudes API 500/hora ∞
Historial de precios No Sí
Webhooks No Sí

Envíame un mensaje privado desde Ko-fi para que pueda proporcionarte el token de acceso.

ko-fi

Contributores