Skip to main content

Descripción general

Los métodos de la API DAS devuelven hasta 1,000 registros por llamada. Para recuperar más, debes paginar: hacer varias llamadas y recorrer páginas de datos. Helius admite dos mecanismos: paginación por páginas y por conjunto de claves. La paginación por páginas es la forma más sencilla de comenzar. La paginación por conjunto de claves está dirigida a usuarios avanzados que necesitan consultar grandes conjuntos de datos (más de 500 mil) de forma eficiente.

Cuándo usar esto

  • Por páginas — vistas estáticas, paneles y la mayoría de las consultas cotidianas. Fácil e intuitiva.
  • Por conjunto de claves (cursor o rango) — grandes conjuntos de datos (colecciones completas, más de 500 mil activos) en los que el recorrido por páginas se vuelve lento.
  • Por conjunto de claves en paralelo — la opción más rápida para analizar una colección completa mediante la partición del rango de direcciones.

Opciones de ordenamiento

Puedes ordenar los resultados por diferentes campos mediante el campo sortBy: Desactivar el ordenamiento produce los resultados más rápidos, pero como los datos no están ordenados, podrías obtener resultados inconsistentes al paginar.

Paginación por páginas

Especifica el número de página y la cantidad de elementos por página. Para avanzar a la página siguiente, incrementa el número de página. Este método es fácil, intuitivo y rápido para la mayoría de los casos de uso.
El uso de páginas requiere que la base de datos recorra todos los elementos hasta llegar a la página siguiente. Por ejemplo, si solicitas la página 100 con un tamaño de página de 1,000, la base de datos debe recorrer el primer millón de registros antes de devolver tus datos. Por este motivo, no se recomienda la paginación por páginas para conjuntos de datos grandes; la paginación por conjunto de claves es mucho más adecuada para esas cargas de trabajo.

Paginación por conjunto de claves

Defines las páginas mediante condiciones que filtran el conjunto de datos. Por ejemplo: «obtén todos los activos con un ID > X, pero con un ID < Y». Recorres todo el conjunto de datos modificando X o Y en cada llamada. Existen dos métodos de paginación por conjunto de claves:
  1. Basada en cursor — más fácil de usar, pero menos flexible.
  2. Basada en rango — más compleja, pero muy flexible.
La paginación por conjunto de claves solo es compatible cuando se ordena por id.

Basada en cursor

Una consulta de DAS sin parámetros de paginación devuelve un cursor. Envía el cursor de vuelta a la API DAS para continuar desde donde te quedaste.
Al momento de redactar esta documentación, el cursor es el ID del último activo de la respuesta; sin embargo, el diseño del cursor es flexible y admite cualquier cadena.

Basada en rango

Para consultar un rango, especifica before y/o after. En esencia, la consulta indica: «obtén todos los activos posteriores a X, pero anteriores a Y». Recorres el conjunto de datos actualizando el parámetro before o after en cada llamada.

Consultas en paralelo con conjuntos de claves (avanzado)

Para obtener un buen rendimiento, los usuarios avanzados que consultan grandes conjuntos de datos (por ejemplo, colecciones completas de NFT comprimidos) deben usar la paginación por conjunto de claves. El siguiente ejemplo muestra cómo realizar consultas en paralelo mediante la partición del rango de direcciones de Solana y el uso de los parámetros before/after. Este método es rápido, eficiente y seguro.
En el siguiente ejemplo, analizamos toda la colección Tensorian (unos 10 mil registros). El proceso divide el espacio de direcciones de Solana en 8 rangos y los analiza simultáneamente. Esto es mucho más rápido que los otros enfoques.

Próximos pasos

Search Assets

Filtra activos por propietario, colección y tokenType.

Get Assets (NFTs)

Recupera NFT, colecciones, ediciones y pruebas.

DAS API reference

Esquemas completos para cada método de DAS.