> ## 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.

# Opensea Trades

### Table Details

| Property            | Value                                                                                                      |
| ------------------- | ---------------------------------------------------------------------------------------------------------- |
| Table Name          | `polygon.nfts.opensea_trades`                                                                              |
| Table Status        | Production-Ready                                                                                           |
| Unique Key          | `block_timestamp::date`, `unique_id`                                                                       |
| Clustering Key(s)   | `block_timestamp::date, protocol, token_address`                                                           |
| Search Optimization | `transaction_hash`, `buyer_address`, `seller_address`, `token_name`, `currency_address`, `currency_symbol` |

### Table Columns

| Column Name                          | Data Type          | Description                                                                                                                                                                                             |
| ------------------------------------ | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| protocol                             | VARCHAR(7)         | Specific version or variant of the protocol (e.g. `uniswap_v3`, `aave_v2`, `stargate_v2`). Qualifies the `project` field with version information.                                                      |
| order\_match\_type                   | VARCHAR(10)        | How the order was fulfilled. `BUY` for a direct purchase at list price; `ACCEPT_BID` for a seller accepting an existing bid.                                                                            |
| trade\_type                          | VARCHAR(12)        | Scope of the trade. `SINGLE_TRADE` for a single NFT, `BUNDLE_TRADE` when multiple NFTs are sold together in one transaction.                                                                            |
| buyer\_address                       | VARCHAR(42)        | Address of the buyer in this NFT trade.                                                                                                                                                                 |
| seller\_address                      | VARCHAR(42)        | Address of the seller in this NFT trade.                                                                                                                                                                |
| token\_standard                      | VARCHAR(16777216)  | Token standard of the NFT. `erc721` for non-fungible tokens (unique IDs, balance 0 or 1), `erc1155` for semi-fungible tokens (multiple copies per ID).                                                  |
| token\_address                       | VARCHAR(42)        | Contract address of the token. For EVM chains, native currency (e.g. ETH, MATIC) is represented as the zero address (0x0000000000000000000000000000000000000000). For Solana, this is the mint address. |
| token\_name                          | VARCHAR(16777216)  | Full name of the token (e.g. "USD Coin", "Wrapped Ether").                                                                                                                                              |
| token\_symbol                        | VARCHAR(16777216)  | Ticker symbol of the token (e.g. "USDC", "WETH").                                                                                                                                                       |
| token\_id                            | VARCHAR(134217728) | Identifier for non-fungible tokens (ERC-721) or semi-fungible tokens (ERC-1155). Each unique token\_id within a collection represents a distinct asset.                                                 |
| item\_quantity                       | VARCHAR(134217728) | Number of NFT items transferred in this trade. Always 1 for ERC-721; may be greater than 1 for ERC-1155 bundle trades.                                                                                  |
| currency\_address                    | VARCHAR(42)        | Contract address of the currency used to pay for the NFT. Native currency (e.g. ETH) is represented as the zero address.                                                                                |
| currency\_symbol                     | VARCHAR(134217728) | Symbol of the currency used to pay for the NFT (e.g. `ETH`, `WETH`, `USDC`).                                                                                                                            |
| usd\_exchange\_rate                  | NUMBER(38,10)      | USD price per unit of the token at the time of the event, used to compute `usd_amount`. Sourced from Allium's hourly price feed.                                                                        |
| raw\_price                           | VARCHAR(134217728) | Price paid for the NFT in the currency's smallest unit (not decimal-adjusted).                                                                                                                          |
| price                                | VARCHAR(134217728) | Price per unit of the asset at the time of this event, in USD or in the quote token's units depending on context.                                                                                       |
| usd\_price                           | VARCHAR(134217728) | USD value of the NFT trade at the time of the transaction.                                                                                                                                              |
| agg\_fees                            | VARIANT            | The aggregate fees of the trade.                                                                                                                                                                        |
| buyer\_fees                          | VARIANT            | The fees paid by the buyer.                                                                                                                                                                             |
| seller\_fees                         | VARIANT            | The fees paid by the seller.                                                                                                                                                                            |
| platform\_fee\_receiver              | VARCHAR(134217728) | Address receiving the marketplace platform fee for this trade (e.g. OpenSea's fee wallet).                                                                                                              |
| raw\_creator\_fee\_1                 | FLOAT              | Raw (not decimal-adjusted) creator royalty amount for the first royalty recipient in this Seaport trade.                                                                                                |
| raw\_creator\_fee\_2                 | FLOAT              | Raw creator royalty amount for the second royalty recipient.                                                                                                                                            |
| raw\_creator\_fee\_3                 | FLOAT              | Raw creator royalty amount for the third royalty recipient.                                                                                                                                             |
| raw\_creator\_fee\_4                 | FLOAT              | Raw creator royalty amount for the fourth royalty recipient.                                                                                                                                            |
| creator\_fee\_receiver\_1            | VARCHAR(42)        | Address of the first creator royalty recipient.                                                                                                                                                         |
| creator\_fee\_receiver\_2            | VARCHAR(42)        | Address of the second creator royalty recipient.                                                                                                                                                        |
| creator\_fee\_receiver\_3            | VARCHAR(42)        | Address of the third creator royalty recipient.                                                                                                                                                         |
| creator\_fee\_receiver\_4            | VARCHAR(42)        | Address of the fourth creator royalty recipient.                                                                                                                                                        |
| aggregator\_name                     | VARCHAR(16777216)  | Name of the aggregator used to route the trade (e.g. `gem`, `blur_aggregator`, `reservoir`). Null or empty if the trade was placed directly on the marketplace.                                         |
| aggregator\_address                  | VARCHAR(16777216)  | Contract address of the aggregator used for the trade. Null if no aggregator was involved.                                                                                                              |
| transaction\_hash                    | VARCHAR(66)        | Hash of the transaction that produced this record. Uniquely identifies a transaction within the blockchain.                                                                                             |
| log\_index                           | NUMBER(38,0)       | Zero-based position of this event log within its transaction. The first log emitted by a transaction has index 0.                                                                                       |
| block\_timestamp                     | TIMESTAMP\_NTZ(9)  | Timestamp (UTC) of the block that contains this record.                                                                                                                                                 |
| block\_number                        | NUMBER(38,0)       | Sequential number of the block that contains this record. Starts at 0 (genesis block) and increments by 1 for each new block.                                                                           |
| block\_hash                          | VARCHAR(66)        | Cryptographic hash of the block header that contains this record. Uniquely identifies a block.                                                                                                          |
| unique\_id                           | VARCHAR(134217728) | Allium's deterministic unique identifier for this row. Generated from the fields that uniquely identify the record (e.g. transaction hash + log index). Stable across full refreshes.                   |
| \_updated\_at                        | TIMESTAMP\_LTZ(9)  | Timestamp of when the entry was last updated in the database.                                                                                                                                           |
| \_helper\_nft\_tokens\_\_updated\_at | TIMESTAMP\_NTZ(9)  | Timestamp (UTC) of the most recent update to the NFT token metadata helper table row referenced by this record.                                                                                         |
| \_changed\_since\_full\_refresh      | BOOLEAN            | Indicates if the record has changed since the last full data refresh.                                                                                                                                   |
