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>"