API REST de Analíticas
Usa esta API para acceder a:
- 📊 Métricas de rendimiento de marketplace
- 🥉 Datos de ventas y volumen a nivel de colección
- 🏆 Top compradores y vendedores
- 📈 Tendencias históricas y datos de leaderboard
URL Base:
https://api.mainnet.aptoslabs.com/v1/analytics/nft
Endpoints de Marketplace
Sección titulada «Endpoints de Marketplace»Obtener Conteo Total de Ventas del Marketplace
Sección titulada «Obtener Conteo Total de Ventas del Marketplace»- GET
/nft/marketplace/total_sales_count - Parámetros:
marketplace(string, requerido) — Identificador del marketplace (ej.topaz,wapal)
- Descripción: Devuelve el número total de ventas completadas para un marketplace dado.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/marketplace/total_sales_count?marketplace=topaz"Endpoints de Colección
Sección titulada «Endpoints de Colección»Obtener Total de Ventas de Colección
Sección titulada «Obtener Total de Ventas de Colección»- GET
/nft/collection/total_sales_count - Parámetros:
collection_id(string, requerido)
- Descripción: Devuelve el número total de ventas completadas para la colección especificada.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/total_sales_count?collection_id=123"Obtener Top Compradores de Colección
Sección titulada «Obtener Top Compradores de Colección»- GET
/nft/collection/top_buyer - Parámetros:
collection_id(string, requerido)limit(integer, opcional, por defecto: 10)offset(integer, opcional, por defecto: 0)
- Descripción: Devuelve los top compradores en la colección, clasificados por monto total gastado.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/top_buyer?collection_id=123&limit=5"Obtener Top Vendedores de Colección
Sección titulada «Obtener Top Vendedores de Colección»- GET
/nft/collection/top_seller - Parámetros:
collection_id(string, requerido)limit(integer, opcional, por defecto: 10)offset(integer, opcional, por defecto: 0)
- Descripción: Devuelve los top vendedores en la colección, clasificados por volumen total vendido.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/top_seller?collection_id=123&limit=5"Obtener Volumen Total de Ventas de Colección
Sección titulada «Obtener Volumen Total de Ventas de Colección»- GET
/nft/collection/total_sales_volume - Parámetros:
collection_id(string, requerido)
- Descripción: Devuelve el volumen total de trading (en APT) para la colección.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/total_sales_volume?collection_id=123"Listar Colecciones por Volumen de Trading
Sección titulada «Listar Colecciones por Volumen de Trading»- GET
/nft/collection/list_by_volume - Parámetros:
limit(integer, máx: 10)offset(integer)time_period(string) —1h,6h,24h,7d,30d
- Descripción: Devuelve colecciones ordenadas por volumen total de ventas dentro de un período de tiempo seleccionado.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/list_by_volume?limit=10&offset=0&time_period=1d"Listar Colecciones por Número de Ventas
Sección titulada «Listar Colecciones por Número de Ventas»- GET
/nft/collection/list_by_sales - Parámetros: Igual que arriba
- Descripción: Devuelve colecciones ordenadas por número total de ventas.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/list_by_sales?limit=10&offset=0&time_period=1d"Listar Colecciones por Precio Base
Sección titulada «Listar Colecciones por Precio Base»- GET
/nft/collection/list_by_floor_price - Parámetros: Igual que arriba
- Descripción: Devuelve colecciones ordenadas por precio base dentro del período de tiempo seleccionado.
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/list_by_floor_price?limit=10&offset=0&time_period=1d"Obtener Número de Tenedores de Token Únicos
Sección titulada «Obtener Número de Tenedores de Token Únicos»- GET
/nft/collection/unique_holders_count - Parámetros:
collection_id(string, requerido)
- Descripción: Devuelve el número de direcciones de wallet únicas que actualmente poseen al menos un token de la colección especificada. Solo se cuentan los tenedores actuales (cantidad > 0).
- Ejemplo:
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/unique_holders_count?collection_id=<collection_id>"