Merge pull request #431 from ChrisMoralis/patch-5

edit discovery api docs

docs/06-market-insights-api/reference/01-Discovery API/overview.md

@@ -33,6 +33,85 @@ Token Insights is a suite of endpoints within the Discovery API that offer vario
 | 9   | `getTrendingTokens`         | Get trending tokens                                        | [Method Documentation](/market-insights-api/reference/get-trending-tokens)                | [https://deep-index.moralis.io/api/v2.2/discovery/tokens/trending](https://deep-index.moralis.io/api/v2.2/discovery/tokens/trending)                       |
 | 10  | `getDiscoveryToken`         | Get token details                                          | [Method Documentation](/market-insights-api/reference/get-token-details)                  | [https://deep-index.moralis.io/api/v2.2/discovery/token](https://deep-index.moralis.io/api/v2.2/discovery/token)                                           |
 
+## API Endpoints and Sorting Parameters
+
+### Rising Liquidity
+Identify tokens with surging liquidity, higher market cap, active social presence, and strong security scores. Positive price trends make them appealing to traders. The 1 month change in liquidity is the underlying metric for this strategy. This metric highlights the ease of trading the asset without significant price impact. An increase in liquidity usually indicates rising interest and a healthy trading environment. Combining liquidity with market cap can provide insights into market stability and growth potential.
+- **Main Filter Metric**: `liquidity_change_usd`
+- **Time Frame**: 1 month
+- **Sorting Order**: DESC
+- **Use Cases**:
+  - **Market Health**: Assesses the health and stability of the market.
+  - **Trading Opportunities**: Identifies tokens with increasing liquidity for better trading opportunities.
+
+### Buying Pressure
+Focus on tokens experiencing substantial buying pressure, driven by increased net volume. These tokens often have significant market cap, social engagement, and price momentum. Net volume is the underlying filter metric for this strategy. This metric indicates the level of buying pressure by measuring the net change in volume of experienced buyers. It helps identify tokens that are gaining interest from knowledgeable investors.
+- **Main Filter Metric**: `experienced_net_buyers_change`
+- **Time Frame**: 1 month
+- **Sorting Order**: DESC
+- **Use Cases**:
+  - **Investment Decision**: Helps investors identify tokens with strong buying interest.
+  - **Market Analysis**: Provides insights into market trends and investor sentiment.
+
+### Solid Performers
+Target tokens with consistently solid buying pressure across multiple timeframes, indicating dependable assets with robust volume, security, and price trends. Uses multi time frame net volume change and total 1 month volume as filters. Net volume is the difference between buyers volume and sellers volume. This indicates the dominant force in the market. Positive buy pressure suggests accumulation and potential for price increases, especially when analyzed alongside experienced net buyers for insights into who is driving the market - retail or more informed entities.
+- **Main Filter Metric**: `net_volume_change_usd`
+- **Time Frame**: 1 month
+- **Sorting Order**: DESC
+- **Use Cases**:
+  - **Performance Analysis**: Identifies consistently performing tokens.
+  - **Market Trends**: Provides insights into ongoing market trends and dominant forces.
+
+### Experienced Buyers
+Powerful indicator of what experienced traders are buying right now. Uses the 1 week experienced buyers metrics as the filter. Buyers with at least 100 outgoing transactions are considered. Filtering by experienced participants provides insights into informed trading behavior, adding weight to the buying signals. This suggests knowledgeable investors are leading or following the market trend.
+- **Main Filter Metric**: `experienced_net_buyers_change`
+- **Time Frame**: 1 week
+- **Sorting Order**: DESC
+- **Use Cases**:
+  - **Informed Trading**: Identifies tokens favored by experienced traders.
+  - **Market Sentiment**: Gauges the sentiment of knowledgeable investors.
+
+### Risky Bets
+Find tokens with lower market cap but promising attributes like net buyers, buyer pressure, steady volume, security, and price trends. Filters out higher market cap coins. This category focuses on lower market cap tokens that might offer higher returns but come with increased risk.
+- **Main Filter Metric**: `market_cap`
+- **Sorting Order**: DESC
+- **Use Cases**:
+  - **High-Risk Investments**: Identifies high-risk, high-reward investment opportunities.
+  - **Market Exploration**: Helps in exploring new and emerging tokens with potential for significant growth.
+
+### Blue Chip
+Focus on established tokens with substantial market cap, recent positive price changes, steady volume, high security, and positive trends, offering stability and reliability. Established tokens, using market cap and token age filters to help remove smaller, newer, risky low cap coins. This strategy focuses on stable, well-established tokens that have proven their reliability over time.
+- **Main Filter Metric**: `price_percentage_change_usd`
+- **Time Frame**: <time frame is based on the request, default = day>
+- **Sorting Order**: DESC
+- **Use Cases**:
+  - **Long-Term Investment**: Identifies stable tokens for long-term investment strategies.
+  - **Portfolio Diversification**: Helps in building a diversified portfolio with reliable tokens.
+
+## Use Cases
+
+### Token Explorer
+One method here, as a workaround, is to create a polling schedule (say, every 10 minutes) to fetch data from all strategies, with loose search parameters and combine the data. This will fetch a large list of tokens. Store them, combine them in your backend, remove duplicates, and then filter the data on the metric you want.
+
+### Token Page Enrichment
+Enrich token pages with data from various strategies to provide comprehensive insights and analytics.
+
+### Serve Lists of Tokens
+Serve lists of tokens that meet certain criteria to wallet pages, analytics tools, exploration pages, trading signals, telegram bots, etc.
+
+### AI Advisors
+After fetch all the token data you want, you can use openai API or another LLM to analyse the data and produce recommendations and signals.
+
+## Gotchas
+- Each strategy returns a maximum of 200 tokens.
+- There is no pagination on the results - coming soon.
+- Custom endpoint to build custom searches - coming soon.
+- Token categories - coming soon.
+- If you need a token's total holders, you can use the owners API.
+
+## How Can I Get Access?
+Speak to our sales team. It's only available within our Enterprise plans. Let's discuss your use case and requirements and we can enable trial access for you to explore the data. Email [email protected] to arrange a demo.
+
 ## Supported Chains
 
 import { EVMChainData } from '@site/src/components/SupportedChains';