Documentación API

En el endpoint https://api.nodecharts.com/v1/metricinfo/{endpoint}/{userhash} puedes consultar los parámetros requeridos por cada métrica.

Puedes obtener los valores de {endpoint} y {userhash} aquí y aquí.

Nodecharts te devolverá una respuesta JSON con los atributos de nombre, descripción, familia a la que pertenece la métrica, el {endpoint} en el que realizarle peticiones y el atributo de parámetros de la métrica.

El atributo “params” nos indica los valores máximo (max) y mínimo (min) que puede tomar cada parámetro, y si son obligatorios (required).

Los parámetros de petición a una métrica son los siguientes:

• “f”: From. Requerido. Número entero. Tiempo Unix inicial de la búsqueda.
• “t”: To. No requerido. Número entero. Tiempo Unix final de la búsqueda. Si no se configura el sistema devolverá datos hasta el presente.
• “i”: Intervalo. Requerido. Cadena de texto. Resolución o intervalo de datos. Puede tomar los siguientes valores:
  • “Block”. Intervalo en bloques.
  • “Hour”. Intervalo en horas.
  • “Day”. Intervalo en días.

Si no se establecen correctamente estos valores la consulta devolverá un error HTTP/1.1 400 Bad Request.

Ejemplo de petición de información sobre configuración de una métrica:

https://api.nodecharts.com/v1/metricinfo/cdd/bGaciOiJIUzs1NiJ9.eyJcpZXJpW1iGIwBpcwV0aW1Q.ufTu8ebD8

Todas las métricas responden con la misma estructura de array JSON que puedes inmediatamente consumir. Estos son sus parámetros:

• “t”: Número entero. Tiempo Unix del dato. En resolución de bloques indica el momento en el que se minó. En resoluciones de día y hora indica el cierre del intervalo.
• “v”: Valor de la métrica.
• “usd”: Precio en $USD al que cotizaba el intervalo solicitado.

Cada suscripción tiene un número de peticiones por minuto máximo, denominado cuota de peticiones. Esta cuota se consume (decrementa) por igual con las peticiones a la API REST o mediante la consulta de gráficas en el Estudio. Las gráficas compuestas pueden suponer la realización de múltiples peticiones simultáneas.

La cuota de peticiones se restablece cada 60 segundos a su máximo disponible según la suscripción contratada.

No todas las peticiones suponen consumo de cuota, como se explica aquí.

En caso de superar las peticiones máximas por minuto el servicio entregará una respuesta HTTP/1.1. 429 Too Many Requests.

Cada métrica dispone de una configuración de restricciones de servicio determinada. Para saber el alcance de datos de tu suscripción desde la propia API puedes consultar en el endpoint https://api.nodecharts.com/v1/metricinfo/{endpoint}/{userhash} el parámetro “memberships”. Compáralo con el id de suscripción que puedes encontrar en tu página de Mi Cuenta.

Valores del atributo “memberships”:

• “membership”: Número entero. Identificador de suscripción al que se aplica cada configuración de restricciones.
• “offsets”: Cantidad de segundos de desplazamiento máximo, según suscripción, hacia atrás en el tiempo. El punto de inicio es el último bloque computado por el sistema, que corresponde al último estado de la cadena de bloques.
  Así, un valor de, por ejemplo, 259200 devolverá ese número de segundos (72 horas) en datos hacia atrás en la cadena de bloques desde el último bloque que el sistema haya computado.
  El valor -1 corresponde a ilimitado.
  Este atributo se divide en los siguientes:
  • “b-offset-block”: Desplazamiento máximo en bloques.
  • “b-offset-hour”: Desplazamiento máximo en horas.
  • “b-offset-day”: Desplazamiento máximo en días.