API PRICE

INTRODUCCIÓN

Esta es la API de consulta de los diferentes precios de criptomoneda a fiat y de las criptomonedas más reconocidas a Petro (PTR). Esta API retorna la información, precio disponible en la API sobre la criptomoneda o moneda fiat deseada a partir de su código en un formato JSON. El mismo tendrá actualizaciones diarias (a las 7 am hora local de Venezuela, para los valores de monedas fiat).

Podrán contar con el valor del Petro en 35 Monedas fiat (según cotizaciones BCV, se anexa tabla de las monedas disponibles ) y 3 criptomonedas (BTC, LTC, DASH).

Esta API es totalmente gratuita.

  • No podemos garantizar una precisión total de los tipos de cambio mostrados.
  • Siempre debe confirmar los tipos de cambio antes de realizar alguna transacción que pueda verse afectada por los cambios en ellos.
  • Tipos de criptodivisas basados en los datos proporcionados por APIs de índices cambiarios.
  • Todos los tipos se muestran solo con carácter informativo y están sujetos a cambios sin previo aviso.
  • Como los tipos de cambio para transacciones reales pueden variar, no nos ofrecemos a entrar en ninguna transacción con ninguno de los tipos que se muestran.
  • Los tipos mostrados son precios compuestos y no están destinados a un uso con fines de inversión.
  • Sunacrip se compromete a tener el API en total operatividad las 24 horas de días, los siete días de la semana, salvo que circunstancias sobrevenidas y externas a su control, afecten la prestación de este servicio.

PARÁMETROS

La API PRICE permite la consulta de los diferentes precios de criptomoneda a fiat y de las criptomonedas más reconocidas a Petro(PTR), a continuación su descripción:

URL:http://api-price.petro.gob.ve/price/
Metodo:Post
Headers:Content-Type: application/json
Claves:coins[“acronimo”,.....] y fiats[“acronimo”,.....]
Body: {
"coins": ["BTC","DASH","LTC","ETH"],
"fiats" : ["USD","ARS","BRL","BOB","CAD","COP","CLP","MXP",
"NIO","PEN","DOP","TTD","UYU","A NG","CZK","DKK"]
}

Las llamadas a la API pueden manejar múltiples parámetros. Por ejemplo, si solicita el precio sobre varias monedas, puede enviar una llamada a la API para todos ellas. El delimitador de parámetro es una coma(,), en lugar de hacer llamadas API separadas por cada moneda.

Ejemplo 1: Diferentes criptos a fiat

Permite consultar el precio de diferentes criptomonedas incluyendo el Petro en las monedas fiat disponibles.

URL: http://api-price.petro.gob.ve/price/

Request:

curl -X POST \
http://api-price.petro.gob.ve/price/ \
-H 'Content-Type: application/json' \
-H 'Host: api-price.petro.dom' \
-d '{ "coins": ["BTC","DASH","LTC","ETH","PTR"],
"fiats" :
["USD","ARS","BRL","BOB","CAD","COP","CLP","MXP","NIO","PEN",
"DOP","TTD","UYU","A NG","CZK","DKK"] }'

imagen-1

Response:

Todos los tipos de respuesta son application / json, de la siguiente manera:

{
"status": 200,
"success": true,
"data": {
"BTC": {
"USD": 11571.1, "ARS": 543197.02, "BRL": 45905, "BOB": 5832216.46,"CAD": 15277.2, "COP": 36523374.46, "CLP": 8248083.07, "NIO": 5095515.44, "PEN": 38671.93,"DOP": 611119.48, "TTD": 95909.15, "UYU": 408957.37,"CZK": 270581,"DKK": 76674.84}, "DASH": { "USD": 104.25, "ARS": 4906.14, "BRL": 412.09, "BOB": 52332.97, "CAD": 137.14, "COP": 327870.33, "CLP": 74010.74,"NIO": 45722.49, "PEN": 347.16, "DOP": 5486.02, "TTD": 860.98, "UYU": 3671.21, "CZK": 2429.01, "DKK": 688.31}, "LTC": {"USD": 89.08, "ARS": 4209.87,"BRL": 354.98, "BOB": 44917.85, "CAD": 117.68, "COP": 281339.55, "CLP": 63524.08, "NIO": 39244.02, "PEN": 297.89, "DOP": 4707.45, "TTD": 738.79, "UYU": 3150.2, "CZK": 2084.29, "DKK": 590.63 }, "ETH": { "USD": 217.33, "ARS": 10263.71, "BRL": 862.1, "BOB": 1567.65, "CAD": 286.91, "COP": 685908.97, "CLP": 154248.97, "NIO": 95693.78, "PEN": 726.26, "DOP": 11476.82, "TTD": 1801.17, "UYU": 7680.22, "CZK": 5081.51, "DKK": 1439.95 }, "PTR": {"USD": 59.73,"DKK": 394.28, "CZK": 1343.75, "ANG": 111.86, "UYU": 2101.2, "TTD": 402.25, "DOP": 3028.73, "PEN": 196.31, "NIO": 1978.9, "MXP": 1139.56, "CLP": 40538.75, "COP": 191690.38, "CAD": 78.41, "BOB": 409.21, "BRL": 228.18, "ARS": 2519.08 } },
"message": "Creado"
}

*Los resultados serán una matriz mientras se consulte el precio para varias criptomonedas.

imagen-2

Nota: En la clave de “fiats” la longitud de los parámetros a enviar tiene un máximo de 100 caracteres de lo contrario arrojara el siguiente error:

{
"status": 200,
"success": true,
"data": {
"Response": "Error", "Message": "tsyms param is invalid. (tsyms length is higher than maxlength: 100)",
"HasWarning": false,
"Type": 2,
"RateLimit": {},
"Data": {},
"ParamWithError": "tsyms",
"PTR": {}
},
"message": "Creado"
}


*el precio devuelto para la criptomenda solicitada se expresa en todas las monedas fiats solicitadas y que se encuentren disponibles en el servicio.

Ejemplo 2: Otras criptos a PTR

Permite consultar el precio en Petros (PTR) de las criptomonedas (BTC, DASH, LTC, ETH), indicando los valores Cripto – Petro y Petro -Cripto.

URL: http://api-price.petro.gob.ve/price/PTR

Request:

curl -X POST \
http://api-price.petro.gob.ve/price/PTR \

-H 'Content-Type: application/json' \
-d '{
"coins": ["BTC","DASH","LTC","ETH"]
}'

imagen-3

Response:
{
"status": 200,
"success": true,
"data": {
"BTC": {
"BTC": 197.98428923,
"PTR": 0.00505091
},
"LTC": {
"LTC": 1.43725156,
"PTR": 0.69577242
},
"DASH": {
"DASH": 1.7427598,
"PTR": 0.57380254
},
"ETH": {
"ETH": 3.55385198,
"PTR": 0.28138482
}
}
}

*el precio devuelto para la criptomoneda solicitada se expresa en Petros (PTR).

imagen-4

SIGLAS

Monedas fiats disponibles en el servicio

Código ISO Moneda País
Bs Bolivar Venezuela
USD Dólar estadounidense Estados Unidos
ARS Peso Argentino Argentina
BRL Real brasileño Brasil
BOB Boliviano Bolivia
CAD Dólar canadiense Canadá
COP Peso colombiano Colombia
CLP Peso chileno Chile
MXP Peso mexicano México
NIO Córdoba nicaragüense Nicaragua
PEN Nuevo sol Perú
DOP Peso dominicano República Dominicana
TTD Dólar trinitense Trinidad y Tobago
UYU Peso uruguayo Uruguay
ANG Curazao Curazao
CZK Corona checa República Checa
DKK Corona danesa Dinamarca
NOK Corona noruega Noruega
GBP Libra británica Reino Unido
SEK Corona sueca Suecia
CHF Franco suizo Suiza
RUB Rublo ruso Rusia
KRW Won surcoreano Corea del Sur
CNY Yuan chino China
TWD Nuevo dólar taiwanés Taiwán
INR Rupia india India
ILS Nuevo shéquel Israel
JPY Yen Japón
HKD Dólar Hong Kong
CNH Renminbi Hong Kong
JOD Dinar jordano Jordania
AUD Dólar australiano Australia
CUC Peso cubano convertible Cuba
DEG D.E.G. D.E.G.
EUR EURO (EUR) Zona Euro
TRY Lira turca Turquía

Criptomonedas disponibles en el servicio.

Código CRIPTOMONEDAS
BTC Bitcoin
DASH Dash
LTC Litecoin
ETH Ethereum

Términos y Condiciones

1.- De la aplicación

1.1.- API Petro Price es una aplicación de uso pública y descarga gratuita, disponible para cualquier usuario que requiera su descarga.

1.2.- API Petro Price permite visualizar el valor equivalente del Petro en 32 divisas y en tres criptomonedas: Bitcoin (BTC), Litecoin (LTC) y Dash.

2.- Los usuarios

2.1.- Pueden ser usuarios y optar a la descarga de la API Petro Price, cualquier persona natural o jurídica, pública o privada.

2.2.- La API Petro Price no requiere ningún tipo de registro por parte de los usuarios para su uso. Por lo tanto, en ninguna situación o circunstancia, se le solicitarán datos o información personal para el registro y uso de esta aplicación a los usuarios interesados en la misma.

3.- Gratuidad del servicio

3.1.- La descarga y el uso de la API Petro Price es completamente gratuita.

3.2.- El servicio prestado por el uso de la API Petro Price no acarrea ningún tipo de costo económico o monetario, para los usuarios.

4.- Disponibilidad del servicio

4.1.- El servicio prestado por la API Petro Price estará disponible las 24 horas del día los siete días de la semana.

4.2.- La API Petro Price y el servicio que presta, puede verse afectado por problemas de conectividad y acceso a la red, sin que esto implique fallas de funcionabilidad en los procesos internos de la aplicación y del servicio prestado.

4.3.- El usuario es consciente y acepta que en los escenarios de fallas de conectividad son externos al funcionamiento y procesos del servicio intrínseco que deriva del uso de la API Petro Price.

4.4.- En cualquier caso, la API Petro Price se mantendrá en estado de actualización constante de las tasas y valores de las diferentes divisas y criptomonedas para generar los resultados del cálculo de equivalencia entre el Petro y las 32 divisas disponibles y entre el Petro y las tres criptomonedas definidas en el numeral 1.2.

5.- Actualización de tasas y valores

5.1.- La API Petro Price tomará como referencia para establecer la equivalencia entre el Petro y las 32 divisas disponibles, las tasas oficiales publicadas por el Banco Central de Venezuela y la Superintendencia Nacional de Criptoactivos y Actividades Conexas (Sunacrip).

5.2.- La API Petro Price tomará como referencia para establecer la equivalencia entre el Petro y el BTC, LTC o Dash, la tasa oficial publicada por la Sunacrip de la fuente que ésta considere confiable.

5.3.- Las tasas de las divisas serán actualizadas cada día a las siete de la mañana, hora oficial de la República Bolivariana de Venezuela.

5.4.- La tasas y valores de los BTC, LTC y Dash se actualizarán en tiempo real.

6.- Exactitud e independencia de los cálculos

6.1.- El usuario de la API Petro Price es consciente y acepta que los resultados arrojados por la misma en el proceso de cálculo y transformación en equivalentes del Petro en las diferentes divisas y criptomonedas, es un proceso exacto que está ajustado a los valores y tasas referenciales especificados en los numerales 5.1 y 5.2.

6.2.- El usuario es consciente que las tasas y valores referenciales que se presentan como resultado del uso de la API Petro Price, son exactos según el valor de referencia empleado, sin embargo, constituyen valores referenciales y en ningún momento pueden tomarse como el valor único, exacto y universalmente establecido de la equivalencia entre el Petro y las 32 divisas disponibles o entre el Petro y las tres criptomonedas disponibles.

6.3.- Los usuarios de la API Petro Price están de acuerdo en que los valores y equivalencias proporcionados como resultados del uso de la aplicación, constituyen valores referenciales, ajustados a tasas oficiales y actualizados en tiempo real.

6.4.- Los usuarios están de acuerdo en que los resultados de la API Petro Price no constituyen una tasa oficial para el intercambio y valoración de la equivalencia entre monedas y criptomonedas entre sí.

6.5.- El usuario acepta y asume como su responsabilidad cualquier negociación establecida con cualquier otra persona, natural o jurídica, pública o privada; empleando los valores referenciales de las equivalencias arrojadas con el uso de la API Petro Price.

6.6.- El usuario acepta que cualquier margen de pérdida o ganancia obtenida en el marco de las negociaciones comentadas en el numeral anterior, son entera y completa responsabilidad.

7.- Disposiciones finales

7.1.- La API Petro Price no se hace responsable por los errores en que incurran los usuarios al momento de ingresar la información relacionada a las divisas o criptomonedas que solicite su equivalencia a través de la aplicación.

7.2.- La API Petro Price es propiedad intelectual registrada, por lo tanto, cualquier uso o copia de cualquier tipo sin la respectiva autorización de sus creadores y desarrolladores, implicará una violación a la normativa y convenios nacionales e internacionales sobre la protección de la propiedad intelectual.

7.3.- Lo no previsto en el presente documento será regulado por las normas jurídicas vigentes y los convenios nacionales o internacionales que regulan el uso y la atención de las aplicaciones web.

El Petro es para todos. Ofrece la seguridad y transparencia que necesitas para hacer transacciones comerciales.

×