Skip to content

La API de pyDolarVenezuela permite obtener información actualizada sobre el precio del dólar y el euro en Venezuela.

License

Notifications You must be signed in to change notification settings

fcoagz/api-pydolarvenezuela

Repository files navigation

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/v2/tipo-cambio

Este endpoint permite obtener el tipo de cambio publicado por el BCV (Banco Central de Venezuela).

Header:

  • Authorization: El token de autorización correspondiente al usuario. (opcional)
Parámetros Tipo Descripción
currency string Opcional. Indica la moneda específica.
format_date string Opcional. Indica el tipo de formato de fecha. (iso, timestamp, default)
rounded_price boolean Opcional. Indica si deseas obtener el precio redondeado.

Nota:

  • 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.

  • El parámetro rounded_price permite obtener el precio redondeado. Por defecto, el precio se muestra con 2 decimales. El cambio solo se aplica a las fuentes que proporcionan precios en decimales grandes.

GET /api/v2/casa-cambio

Este endpoint permite obtener el tipo de cambio de diferentes casas de cambio en Venezuela. Devuelve información sobre el valor del dólar según las tasas publicadas por cada casa de cambio.

Header:

  • Authorization: El token de autorización correspondiente al usuario. (opcional)
Parámetros Tipo Descripción
exchange_house string Opcional. Indica la casa de cambio específica.
rounded_price boolean Opcional. Indica si deseas obtener el precio redondeado.

GET /api/v2/market-p2p

Este endpoint proporciona información sobre el mercado P2P. Permite consultar el precio de referencia de USDT, mostrando el valor mínimo disponible en las ofertas públicas de cada plataforma.

Header:

  • Authorization: El token de autorización correspondiente al usuario. (opcional)
Parámetros Tipo Descripción
platform string Opcional. Plataforma P2P a consultar.
format_date string Opcional. Formato de fecha (iso, timestamp, default).
rounded_price boolean Opcional. Indica si deseas obtener el precio redondeado.

GET /api/v2/<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:

  • Fuentes directas:
Página web Ruta
Banco Central de Venezuela api/v1/dollar?page=bcv
Italcambio api/v1/dollar?page=italcambio
Zoom Venezuela api/v1/dollar?page=zoom
AlCambio api/v1/dollar?page=alcambio

Ruta:

  • currency: La moneda en la que se expresarán los precios (dollar, euro).

Header:

  • Authorization: El token de autorización correspondiente al usuario. (opcional)
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)
rounded_price boolean Opcional. Indica si deseas obtener el precio redondeado.

GET /api/v2/<currency>/history

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

Ruta:

  • currency: La moneda en la que se expresarán los precios (dollar, euro).

Header:

  • Authorization: El token de autorización correspondiente al usuario.
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)
rounded_price boolean Opcional. Indica si deseas obtener el precio redondeado.
order string Opcional. Indica el orden del historial. (asc, desc)

Nota:

  • El parámetro order permite obtener el historial en orden ascendente o descendente. Por defecto, el historial se muestra en orden descendente. Quiere decir que la fecha más reciente aparecerá primero.

GET /api/v2/<currency>/changes

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

Ruta:

  • currency: La moneda en la que se expresarán los precios (dollar, euro).

Header:

  • Authorization: El token de autorización correspondiente al usuario.
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)
rounded_price boolean Opcional. Indica si deseas obtener el precio redondeado.
order string Opcional. Indica el orden del historial. (asc, desc)

GET /api/v2/<currency>/conversion

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

Ruta:

  • currency: La moneda en la que se expresarán los precios (dollar, euro).

Header:

  • Authorization: El token de autorización correspondiente al usuario. (opcional)
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.

Resultado que te devolverá la API

{
  "monitors": [
    {
      "change": 0.00,
      "color": "string",
      "image": "url",
      "last_update": "date-time-iso",
      "percent": 0.00,
      "price": 0.00,
      "price_old": 0.00,
      "symbol": "string",
      "title": "string",
      "key": "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.

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/v2/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/v2/tipo-cambio?currency=usd"

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 Usuario Token
Solicitudes API 500/dia 12k/dia
Historial de precios No
Webhooks No No

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

ko-fi

Contributores

About

La API de pyDolarVenezuela permite obtener información actualizada sobre el precio del dólar y el euro en Venezuela.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project