# On-chain Data Source

👉 **Access Crunchie here:** [campaigns.datai.network/crunchie](https://campaigns.datai.network/crunchie) currently in its early **phases**

## Liquidity Pool Data

* Protocols: Uniswap, PancakeSwap, TraderJoe, Curve, SushiSwap, QuickSwap, Velodrome, Aerodrome, etc.
* Chains: Ethereum, BSC, Polygon, Avalanche, Arbitrum, Optimism, Base
* Metrics: APY (current, 7d, 30d), TVL (total value locked), 24h trading volume, pool ranking, Buy/Sell Pressure (BSP) signals

### Buy Sell Pressure Ranges

* 80–100 = strong buying pressure
* 60–79 = moderate buying interest
* 40–59 = neutral
* 20–39 = selling pressure
* 0–19 = heavy selling

### TVL Tiers

* $1M = high liquidity
* $100K–$1M = moderate
* <$100K = risky slippage

### Pool Ranking

Crunchie's pool assessment combines **seven key factors** that together provide a holistic view of pool quality. Each factor is weighted based on its importance for long-term liquidity provision success, and the factors are combined into a **single composite score ranging from 0.00 to 1.00**.

#### 1. APY Stability

**Purpose:** Evaluates the consistency of yield over time.

**How It Works:**

* Compares current APY performance against historical averages (7-day and 30-day periods)
* Rewards pools with stable, predictable yields
* Penalizes pools with highly volatile or erratic APY patterns

**Why It Matters:**\
Sustainable yield farming requires predictable returns. Pools with stable APY are less likely to experience sudden drops that could lead to losses or impermanent gain reversals.

#### 2. Trading Volume

**Purpose:** Measures the level of trading activity in the pool.

**How It Works:**

* Evaluates 24-hour trading volume in USD
* Uses tiered scoring that rewards higher volume levels
* Higher volume indicates active market participation

**Why It Matters:**\
High trading volume ensures liquidity providers can easily enter and exit positions. It also generates more trading fees, which contribute to APY, and reduces slippage for large trades.

#### 3. Total Value Locked (TVL)

**Purpose:** Assesses the depth of liquidity in the pool.

**How It Works:**

* Evaluates the total USD value of assets locked in the pool
* Uses tiered scoring that rewards substantial liquidity depth
* Higher TVL indicates greater market confidence

**Why It Matters:**\
Pools with higher TVL provide better price stability, reduce the impact of large trades on token prices, and lower the risk of impermanent loss. They also indicate that other liquidity providers have confidence in the pool.

#### 4. Current APY

**Purpose:** Evaluates the current yield potential.

**How It Works:**

* Assesses the current annual percentage yield
* Uses tiered scoring that rewards attractive yields while considering sustainability
* Balances high returns with realistic expectations

**Why It Matters:**\
While APY is an important factor, extremely high APY can be unsustainable or indicate high risk. The scoring balances yield attractiveness with other stability factors.

#### 5. Organic Trading Activity

**Purpose:** Distinguishes genuine market activity from automated bot trading.

**How It Works:**

* Analyzes transaction patterns to identify human traders vs. automated bots
* Calculates the percentage of trading volume from organic (human) activity
* Rewards pools with higher organic trading participation

**Why It Matters:**\
Organic trading activity indicates real market demand and sustainable trading patterns. Pools dominated by bot activity may experience sudden changes if bots withdraw, leading to instability.

#### 6. User Diversity

**Purpose:** Measures the breadth of participation in the pool.

**How It Works:**

* Counts unique wallet addresses that have interacted with the pool
* Evaluates the diversity of participants over a 24-hour window
* Rewards pools with broader user participation

**Why It Matters:**\
A diverse user base reduces concentration risk and indicates community trust. Pools with many participants are less vulnerable to single-entity manipulation or sudden withdrawals.

#### 7. Activity Consistency

**Purpose:** Evaluates sustained engagement over time.

**How It Works:**

* Analyzes trading activity patterns over a 30-day period
* Measures how consistently the pool has maintained activity
* Rewards pools with steady, ongoing engagement

**Why It Matters:**\
Consistent activity indicates long-term viability and reduces the risk of pool abandonment. Pools with sporadic activity may be temporary or less reliable.

#### Composite Scoring

The final pool score is calculated by combining all seven factors with their respective weights.

The scoring system:

* **Balances multiple dimensions:** No single factor dominates the score
* **Prioritizes stability:** Factors like APY stability and activity consistency carry significant weight
* **Rewards quality:** High organic activity and user diversity are valued
* **Considers sustainability:** Combines current performance with historical patterns

**Score Ranges:**

* **0.90 – 1.00:** Excellent pools with strong fundamentals across all dimensions
* **0.70 – 0.89:** High-quality pools with solid performance
* **0.50 – 0.69:** Good pools with acceptable quality
* **Below 0.50:** Pools may have areas of concern or lower quality

#### Ranking Logic

Pools are ranked based on:

1. **Primary Sort:** Composite score (highest to lowest)
2. **Secondary Sort:** Trading volume (for pools with similar scores)
3. **Quality Filtering:** Minimum thresholds for TVL and volume to ensure basic viability

#### Score Reasons Examples

* **High APY stability:** Consistent yield over time
* **High 24h volume:** Strong trading activity
* **High TVL:** Substantial liquidity depth
* **High current APY:** Attractive yield
* **High share of organic volume:** Genuine trading activity
* **High number of unique users:** Broad user adoption
* **Strong 30d hourly activity:** Consistent engagement

## Lending/Borrowing Data

* Coverage:
  * Ethereum: Aave v3, Spark, Compound, Compound v3, MakerDAO/Sky, Venus
  * Arbitrum: Aave v3, Compound v3, Venus
  * Base: Aave v3, Moonwell, Compound v3
  * BSC: Venus (Liquid Staked BNB, Core, GameFi), Aave v3
  * Optimism: Aave v3, Compound v3, Moonwell
  * Polygon: Aave v3, Compound v3
  * Avalanche: Aave v3, Benqi
* Metrics: supply and borrow APY (current, 7d, 30d)

## News & Sentiment Data

* Latest DeFi news (48h window)
* Sentiment scores:&#x20;
  * Positive (> 0.1)
  * Neutral (-0.1 to 0.1)
  * Negative (< -0.1)
* Level of confidence:&#x20;
  * High (more than 100 articles)
  * Medium (30 to 100 articles)
  * Low (10 to 30 articles)
  * Very low (less than 10 articles)

## **Disclaimer**

Please note that Crunchie is currently in its early **phases**.&#x20;

Crunchie is designed to provide **data analysis and educational insights** only. It is not in any way aimed to give financial, investment, or legal advice.

Always conduct your own research (**DYOR**) before making any financial or trading decisions.


---

# 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://datum.datai.network/datai-campaign-hub/phase-1-crunchie/on-chain-data-source.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.
