Saltar al contenido principal
La referencia de la API se genera del mismo código que la sirve, así que siempre coincide con lo que responde. Cada endpoint trae su costo en créditos, sus parámetros, la forma de la respuesta y un playground para probarlo con tu clave.
El playground manda la consulta de verdad a la API de producción, con tu clave, y la consulta se cobra como cualquier otra. Para explorar sin gastar créditos, empezá por los endpoints que no cuestan: GET /v1/account, GET /v1/chains, GET /v1/sources y GET /v1/methodology.
Todas las rutas van contra la base URL https://app.blockgence.com (con el prefijo /v1). El esquema crudo está en https://app.blockgence.com/openapi.json, por si querés generar un cliente.

Convenciones

Redes

La mayoría de los endpoints aceptan chain (ethereum por defecto): ethereum, bsc, polygon, arbitrum, base u optimism, en minúsculas, y tron en los que lo indican. Una red que no está soportada, o mal escrita, responde 400 con la lista de las que sí y no se cobra: nunca se responde con datos de otra red. Qué se puede consultar en cada red (transferencias, logs, trazas, labels, seguridad…) lo dice GET /v1/chains, sin costo.

Direcciones y hashes

  • Una dirección EVM es 0x seguido de 40 caracteres hexadecimales; se normaliza a minúsculas.
  • Un hash de transacción es 0x seguido de 64 hexadecimales.
  • Algunos endpoints aceptan además direcciones de Tron o de Monero: van tal cual, porque su formato distingue mayúsculas.

Montos

  • value es el monto con los decimales del token aplicados.
  • Si los decimales del token no se pudieron obtener, value es null y el monto exacto va en amount_raw, como texto. Nunca se asumen decimales ni se muestra un 0.
  • Los montos en USD son a la fecha de cada transacción, no al precio de hoy. La respuesta dice de dónde salió el precio.

Fechas

Las fechas son epoch en segundos (UTC), salvo donde la referencia diga otra cosa.

Cobertura

Toda respuesta que lee fuentes de datos puede traer degraded_sources: lo que no se pudo leer y por qué. Leela antes de concluir que algo «no está». Ver Errores y Paginación y cortes.

Hechos y pistas

Las respuestas separan lo que es un hecho on-chain de lo que es una pista heurística. Cuando una afirmación es probabilística, trae su base (basis), su confianza (confidence) o sus motivos (reasons). La metodología completa, con cada regla, sus límites y el estado de su tasa de error (medida o todavía no), la publica GET /v1/methodology.

Probar sin código

1

Elegí un endpoint en la referencia

Por ejemplo, Account → Consumo y límites de tu API key (GET /v1/account), que no cuesta créditos.
2

Abrí el playground

Con el botón Pruébalo, al lado de la ruta.
3

Pegá tu clave

En Autorización, en el campo X-API-Key, tal cual (bkg_live_…, sin Bearer).
4

Mandá la consulta

Con Enviar. La respuesta aparece en el mismo panel.