Listas paginadas
Los endpoints que devuelven una lista larga de resultados ya calculados se paginan conoffset y limit. Por ejemplo,
POST /v1/counterparties, que trae todas las contrapartes de una dirección, ordenadas por valor en USD:
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 endegraded_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ó contransfers.truncated, pedilo de nuevo en POST /v1/trace como address,
con su since y con read_more:
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.
Con
false no expande hacia adelante y lee solo hacia atrás (back_hops): sirve para releer un padre.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_totalconcandidates_truncated: true); *_truncated: truecuando una lista se cortó (refs_truncated,contracts_truncated);- un resumen de lo descartado, como
unpriceden las contrapartes: cuántas filas de tokens sin precio publicado se dejaron afuera, y de qué contratos.