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 aceptanchain (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
0xseguido de 40 caracteres hexadecimales; se normaliza a minúsculas. - Un hash de transacción es
0xseguido de 64 hexadecimales. - Algunos endpoints aceptan además direcciones de Tron o de Monero: van tal cual, porque su formato distingue mayúsculas.
Montos
valuees el monto con los decimales del token aplicados.- Si los decimales del token no se pudieron obtener,
valueesnully el monto exacto va enamount_raw, como texto. Nunca se asumen decimales ni se muestra un0. - 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 traerdegraded_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.