> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo leer la referencia

> Dónde está la referencia de cada endpoint, cómo probarla y las convenciones que comparten todas las respuestas.

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.

> [!TIP]
>
> 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](https://docs.blockgence.com/es/api/errors.md) y [Paginación y cortes](https://docs.blockgence.com/es/api/pagination-and-cutoffs.md).

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.