Saltearse al contenido

Referencia de Tablas del Agregador NFT

Esta página documenta las tablas PostgreSQL generadas y actualizadas por el Agregador NFT.
Estas tablas alimentan tanto la API GraphQL como la API REST, y reflejan el estado en vivo de la actividad de marketplace en Aptos.

Para consultas, consulta:


Nombre de TablaDescripción
nft_marketplace_activitiesDatos históricos de todos los eventos de marketplace NFT
current_nft_marketplace_listingÚltimos listings activos por token
current_nft_marketplace_token_offerÚltimas ofertas activas por token y comprador
current_nft_marketplace_collection_offerÚltimas ofertas activas por colección
current_collections_v2Últimas colecciones activas
current_token_datas_v2Últimos tokens activos
current_token_ownerships_v2Últimas propiedades de token activas
current_collection_ownerships_v2_viewÚltimas propiedades de colección activas
  • Usa is_deleted = false para consultar solo registros activos en tablas de estado actual.
  • La tabla nft_marketplace_activities es tu fuente de verdad para actividad histórica de marketplace.

Tabla histórica que captura todos los eventos de marketplace NFT — listings, ofertas, ventas, y más. Tiene una vista agregada para datos de resumen llamada nft_marketplace_activities_aggregate.

Clave Primaria: txn_version, index, marketplace

Nombre de ÍndiceColumnas
idx_collection_event_tscollection_id, standard_event_type, block_timestamp DESC
idx_token_idtoken_data_id
idx_buyerbuyer
idx_sellerseller
idx_listing_idlisting_id
idx_offer_idoffer_id
idx_timestampblock_timestamp DESC
CampoTipoDescripción
txn_versioni64Versión blockchain de la transacción
indexi64Índice del evento en la transacción
listing_idOption<String>ID del listing (si aplica)
offer_idOption<String>ID de la oferta (si aplica)
raw_event_typeStringTipo de evento de marketplace crudo
standard_event_typeStringTipo de evento normalizado
creator_addressOption<String>Dirección del creador de colección
collection_idOption<String>Identificador de colección
collection_nameOption<String>Nombre de colección
token_data_idOption<String>Identificador de token
token_nameOption<String>Nombre de token
pricei64Precio en Octas
token_amountOption<i64>Cantidad de token (para bundles etc.)
buyerOption<String>Dirección del comprador
sellerOption<String>Dirección del vendedor
expiration_timeOption<String>Tiempo de expiración de listing/oferta
marketplaceStringNombre del marketplace
contract_addressStringDirección del contrato del marketplace
json_dataserde_json::ValuePayload de evento crudo interno (no público)
block_timestampNaiveDateTimeTimestamp del bloque del evento

Rastrea listings activos actuales. Actualizado en tiempo real.

Clave Primaria: token_data_id, marketplace

Nombre de ÍndiceColumnas
idx_current_nft_marketplace_listings_token_data_idtoken_data_id
idx_current_nft_marketplace_listings_collection_idcollection_id
idx_current_nft_marketplace_listings_collection_id_pricecollection_id, price
idx_current_nft_marketplace_listings_sellerseller
CampoTipoDescripción
token_data_idStringIdentificador de token
listing_idOption<String>ID del listing
collection_idOption<String>Identificador de colección
sellerStringDirección del vendedor
pricei64Precio del listing
token_amounti64Número de tokens listados
token_nameOption<String>Nombre del token
standard_event_typeStringTipo de evento normalizado
is_deletedboolTrue si el listing está inactivo
marketplaceStringNombre del marketplace
contract_addressStringDirección del contrato del marketplace
last_transaction_versioni64Última versión de transacción
last_transaction_timestampNaiveDateTimeÚltimo timestamp de actualización

Rastrea ofertas de token activas actuales por token y comprador.

Clave Primaria: token_data_id, buyer, marketplace

Nombre de ÍndiceColumnas
idx_current_nft_marketplace_token_offers_token_data_idtoken_data_id
idx_current_nft_marketplace_token_offers_priceprice
idx_current_nft_marketplace_token_offers_buyerbuyer
CampoTipoDescripción
token_data_idStringIdentificador de token
offer_idOption<String>ID de la oferta
buyerStringDirección del comprador
collection_idStringIdentificador de colección
pricei64Precio de la oferta
token_amountOption<i64>Cantidad de token
token_nameOption<String>Nombre del token
standard_event_typeStringTipo de evento normalizado
bid_keyOption<i64>Clave de puja única
is_deletedboolEstado activo de la oferta
marketplaceStringNombre del marketplace
contract_addressStringDirección del contrato del marketplace
last_transaction_versioni64Última versión de transacción
last_transaction_timestampNaiveDateTimeÚltimo timestamp de actualización

Rastrea ofertas activas actuales a nivel de colección.

Clave Primaria: collection_offer_id

Nombre de ÍndiceColumnas
idx_current_nft_marketplace_collection_offers_collection_idcollection_id
idx_current_nft_marketplace_collection_offers_token_data_idtoken_data_id
idx_current_nft_marketplace_collection_offers_collection_offer_id_token_data_idcollection_offer_id, token_data_id
CampoTipoDescripción
collection_offer_idStringID único de oferta de colección
token_data_idStringIdentificador de token
collection_idStringIdentificador de colección
buyerStringDirección del comprador
pricei64Precio de la oferta
remaining_token_amountOption<i64>Cantidad restante en la oferta
standard_event_typeStringTipo de evento normalizado
is_deletedboolEstado activo de la oferta
marketplaceStringNombre del marketplace
contract_addressStringDirección del contrato del marketplace
last_transaction_versioni64Última versión de transacción
last_transaction_timestampNaiveDateTimeÚltimo timestamp de actualización

Más información sobre tablas (ej. current_token_datas_v2, current_collections_v2, current_token_ownerships_v2, current_collection_ownerships_v2_view) está disponible aquí