> For the complete documentation index, see [llms.txt](https://docs.artinals.com/artinals-protocol/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.artinals.com/artinals-protocol/sale-module/data-structures/nftlisting.md).

# NFTListing

`NFTListing` represents individual NFT entries within a given sale. This structure provides a clear and organized way to manage specific NFTs within a larger sale context.

**Key fields:**

* **`id`:** A unique identifier for the listing object. This allows for easy reference and management of individual listings.
* **`nft`:** The actual NFT object being listed. This provides direct access to the NFT's properties and metadata.
* **`sale_id`:** Links the listing to its parent `NFTSale` object. This establishes a clear relationship between the listing and the overarching sale.
* **`asset_id`:** Identifies the NFT within its collection using its unique asset ID. This helps distinguish NFTs within the same collection.
* **`price`:** The price at which the NFT is offered for sale. This can be different from the default `price_per_nft` in the `NFTSale` object, allowing for individual pricing of NFTs.

**Benefits of `NFTListing`:**

* **Granular Control:** Separating `NFTSale` (the overall sale) from `NFTListing` (individual entries) provides more granular control over which NFTs are included in a sale and at what prices.
* **Targeted Purchases:** Buyers can identify and purchase specific NFTs within a sale based on their individual `asset_id` and `price`, rather than treating the sale as an indistinguishable batch of NFTs.
* **Flexibility:** This structure allows for greater flexibility in managing sale listings. For example, sellers can adjust the price of individual `NFTListing` objects without affecting the overall sale parameters.
* **Organization:** `NFTListing` objects help maintain a clear and organized structure for managing NFTs within a sale, improving efficiency and readability.

By utilizing the `NFTListing` structure, the SALE module enables a more refined and user-friendly experience for both sellers and buyers, enhancing the overall marketplace functionality.