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 camposortBy:
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.Example
Example
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:- Basada en cursor — más fácil de usar, pero menos flexible.
- Basada en rango — más compleja, pero muy flexible.
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.Example
Example
Basada en rango
Para consultar un rango, especificabefore 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.
Example
Example
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ámetrosbefore/after. Este método es rápido, eficiente y seguro.
Example
Example
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.