Saltearse al contenido

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


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:
Ventana de terminal
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/marketplace/total_sales_count?marketplace=topaz"

  • 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:
Ventana de terminal
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/total_sales_count?collection_id=123"

  • 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:
Ventana de terminal
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/top_buyer?collection_id=123&limit=5"

  • 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:
Ventana de terminal
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:
Ventana de terminal
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/total_sales_volume?collection_id=123"

  • 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:
Ventana de terminal
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/list_by_volume?limit=10&offset=0&time_period=1d"

  • GET /nft/collection/list_by_sales
  • Parámetros: Igual que arriba
  • Descripción: Devuelve colecciones ordenadas por número total de ventas.
  • Ejemplo:
Ventana de terminal
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/list_by_sales?limit=10&offset=0&time_period=1d"

  • 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:
Ventana de terminal
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:
Ventana de terminal
curl "https://api.mainnet.aptoslabs.com/v1/analytics/nft/collection/unique_holders_count?collection_id=<collection_id>"