Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.allium.so/llms.txt

Use this file to discover all available pages before exploring further.

The NFT Trades table aggregates ERC721 and ERC1155 token sales from popular NFT marketplaces and protocols. Our current NFT trades model supports single-currency trades (trades involving either one ERC20 token or ETH alone), which constitute most of the current NFT trades.

Coverage:

ProtocolMarketplace
payment_processor_v2unlabeled, magiceden
sudoswap_v2sudoswap
zoniczonic
elementelement
seaportmagiceden, alienswap, unlabeled, okx, opensea

Table Columns

Unique Key: unique_id
Column NameData TypeDescription
marketplacevarcharMarketplace where the trade occurred (e.g., opensea, aavegotchi, magiceden, oneplanet, nftkey)
protocolvarcharProtocol used for the trade (e.g., x2y2, seaport)
order_match_typevarcharType of order match: ‘ACCEPT_BID’ or ‘BUY’
trade_typevarcharType of trade: ‘SINGLE_TRADE’ or ‘BUNDLE_TRADE’
buyer_addressvarcharAddress of the buyer
seller_addressvarcharAddress of the seller
token_standardvarcharToken standard of the NFT (e.g., ERC721, ERC1155)
token_addressvarcharContract address of the NFT collection
token_idvarcharID of the NFT traded
token_namevarcharName of the NFT collection
token_symbolvarcharSymbol of the NFT collection
item_quantitybigintNumber of NFTs bought
currency_addressvarcharAddress of the currency used in the trade (zero address for native tokens)
currency_symbolvarcharSymbol of the currency used in the trade
raw_pricefloatPrice of the NFT in the original currency (not divided by decimals)
pricefloat’raw_price’ divided by the number of decimals of the currency
usd_pricefloatUSD price of the NFTs in this trade
agg_feesvariantAggregated fees information including creator, platform, and total fees
buyer_feesvariantFees paid by the buyer
seller_feesvariantFees paid by the seller
aggregator_namevarcharName of the aggregator used for the trade (if applicable)
aggregator_addressvarcharContract address of the aggregator used for the trade (if applicable)
extra_fieldsvariantAdditional information specific to the trade or protocol
transaction_hashvarcharTransaction hash of this trade
block_timestamptimestamp_ntz(9)Timestamp of the block when the trade occurred
block_numberbigintNumber of the block when the trade occurred
block_hashvarcharHash of the block when the trade occurred
unique_idvarcharUnique identifier for each trade