Saltar al contenido principal
Las consultas on-chain leen listados que pueden ser enormes. La API pone topes para responder a tiempo y con un costo predecible, y declara siempre lo que quedó afuera. Hay dos mecanismos distintos: listas paginadas y lecturas con tope.

Listas paginadas

Los endpoints que devuelven una lista larga de resultados ya calculados se paginan con offset y limit. Por ejemplo, POST /v1/counterparties, que trae todas las contrapartes de una dirección, ordenadas por valor en USD:
Pedí la página siguiente con offset = next_offset hasta que has_more sea false. limit acepta hasta 100.
Cada página es una consulta y se cobra. Si la fuente no puede leer la dirección, la respuesta es 503 source_unavailable, nunca «0 contrapartes».

Lecturas con tope

Para armar un rastreo, la API lee el historial de cada dirección desde las fuentes de datos. Esa lectura tiene un tope de filas por listado. Cuando una dirección tiene más actividad de la que entra, una parte del historial no se lee, y la respuesta lo declara en degraded_sources y en el nodo afectado (coverage_gaps): El mensaje de cada corte dice qué bloques de qué listado faltan. Lo que quedó afuera no es «sin movimientos».
La lectura se enfoca en el rastro: en un nodo cortado, primero se lee desde el bloque donde llegaron los fondos rastreados hacia adelante (o desde su salida hacia atrás). Así el tope se gasta en lo que importa para seguir la plata, no en la actividad más nueva de la dirección.

«Leer más»

Para seguir leyendo un nodo que quedó con transfers.truncated, pedilo de nuevo en POST /v1/trace como address, con su since y con read_more:
integer
predeterminado:"0"
Pasos extra de lectura para el nodo semilla: cada paso suma otro tope de filas por listado. Va de 0 a 9; un valor mayor se acota.
boolean
predeterminado:"true"
Con false no expande hacia adelante y lee solo hacia atrás (back_hops): sirve para releer un padre.
Lo que ya se leyó de ese nodo en los últimos 15 minutos no se vuelve a pedir a la fuente: cada paso cuesta solo sus lecturas nuevas. Si el corte sigue, subí read_more (2, 3…). En la aplicación web es el botón Leer más del nodo.

Otros topes declarados

Algunas respuestas acotan sus listas internas para no crecer sin límite. Cuando cortan, lo dicen con un campo propio:
  • un contador del total y la lista recortada (por ejemplo, discarded_total con candidates_truncated: true);
  • *_truncated: true cuando una lista se cortó (refs_truncated, contracts_truncated);
  • un resumen de lo descartado, como unpriced en las contrapartes: cuántas filas de tokens sin precio publicado se dejaron afuera, y de qué contratos.
La referencia de cada endpoint dice qué tope tiene y cómo lo declara.