# Examples & Best Practices

### Example Workflows

This section provides example workflows demonstrating how to integrate the ART20 and SALE modules with the new trade features to create comprehensive NFT management and trading experiences.

#### 1. Create and Sell a New Collection with a Trading Pool:

* **Create Collection (ART20):**
  * Use `mint_art20` to set up a new collection with a name, description, and initial supply of NFTs.
* **Initialize Deny List (Optional):**
  * If needed, use `initialize_deny_list` and `add_to_deny_list` from the ART20 module to restrict certain addresses.
* **Create a Trading Pool (SALE):**
  * Use `create_trade_pool` to establish a trading pool for the new collection, specifying the currency for trading.
* **List Initial NFTs (SALE):**
  * Use `create_sell_order` to list a portion of the initial NFTs in the pool at a desired starting price. This creates the first sell orders in the order book.
* **Handle Trades (SALE):**
  * As buyers place buy orders using `create_buy_order`, the `match_orders` function automatically matches compatible orders and executes trades.
* **Manage Orders (SALE):**
  * Users can cancel their orders using `cancel_order` if needed.
* **Withdraw Proceeds (SALE):**
  * Sellers can withdraw their earnings from the pool using `withdraw_currency`, with the option to split proceeds among multiple recipients.

#### 2. Add More NFTs to an Active Trading Pool:

* **Additional Minting (ART20):**
  * If the initial supply in the pool is low, call `mint_additional_art20` to create more NFTs (ensuring `max_supply` is not exceeded).
* **Add to Existing Pool (SALE):**
  * Use `create_sell_order` to add the newly minted NFTs to the existing pool at the desired price. This increases the available supply for trading.

#### 3. Dynamically Adjust Prices and Orders:

* **Monitor Market (Off-chain):**
  * Use off-chain tools or applications to monitor market activity, track price changes, and analyze liquidity metrics.
* **Adjust Orders (SALE):**
  * Based on market observations, users can cancel existing orders using `cancel_order` and create new orders with adjusted prices using `create_sell_order` or `create_buy_order`.
* **Analyze Liquidity (SALE):**
  * Utilize `get_liquidity_metrics` and `get_liquidity_depth` to analyze the current liquidity conditions in the pool and make informed trading decisions.

#### Best Practices:

* **Set Competitive Prices:** Analyze market trends and competitor pricing to set competitive prices for your NFTs.
* **Provide Sufficient Liquidity:** Ensure adequate liquidity in the pool by listing a reasonable number of NFTs at various price points.
* **Monitor and Adjust Orders:** Actively monitor market conditions and adjust your orders accordingly to maximize trading opportunities.
* **Communicate with Users:** Keep users informed about any changes to the trading pool, such as new listings or price adjustments.
* **Encourage Participation:** Promote the trading pool and incentivize users to participate by offering competitive prices and favorable trading conditions.

By combining the core features of the ART20 and SALE modules with these trade functionalities and best practices, you can create a dynamic and engaging NFT marketplace that fosters user participation, price discovery, and a thriving ecosystem for your digital collectibles.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.artinals.com/artinals-protocol/examples-and-best-practices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.