# Liquidity Module

This module provides tools for analyzing liquidity within NFT trading pools. It helps users understand market depth, assess the ease of buying and selling NFTs, and identify potential trading opportunities.

**Key Features:**

* **Liquidity Metrics:** The module calculates and returns various liquidity metrics, such as total bid and ask volumes, bid-ask ratio, and market depth.
* **Liquidity Depth:** It provides detailed liquidity depth information by analyzing price levels, order volumes, and weighted average prices.

**Functions:**

* **`analyze_pool_liquidity<CURRENCY>`:** Performs a comprehensive liquidity analysis for a given pool, returning both liquidity metrics and depth information.
* **`get_liquidity_metrics<CURRENCY>`:** Calculates and returns key liquidity metrics for a pool.
* **`get_liquidity_depth<CURRENCY>`:** Analyzes price levels and order volumes to provide detailed liquidity depth information.

By integrating the `PRICE_INDEX` and `LIQUIDITY` modules into your NFT marketplace, you can offer users valuable tools for understanding market trends, analyzing liquidity, and making informed trading decisions. This contributes to a more transparent and efficient marketplace, empowering both buyers and sellers with the information they need to participate effectively.


---

# 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/sale-module/liquidity-module.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.
