# Predictive Whale Movement Analysis

**Implementation Details**

**Class Names**

| Model Name              | Parameters Class           | Data Class          |
| ----------------------- | -------------------------- | ------------------- |
| PredictiveWhaleMovement | PredictiveWhaleQueryParams | PredictiveWhaleData |

**Import Statement**

```python
pythonCopyEditfrom satoshi_terminal.models.predictive_whale_movement import (
    PredictiveWhaleMovement,
    PredictiveWhaleQueryParams,
    PredictiveWhaleData,
)
```

***

**Parameters**

| Name               | Type                    | Description                                                     | Default | Optional |
| ------------------ | ----------------------- | --------------------------------------------------------------- | ------- | -------- |
| wallet\_address    | Union\[str, List\[str]] | Wallet address(es) of whales to monitor.                        | None    | False    |
| movement\_type     | str                     | Type of movement to predict (e.g., "Accumulation," "Sell-off"). | None    | True     |
| prediction\_window | int                     | Forward-looking window (in hours) for movement predictions.     | 24      | True     |

***

**Data**

| Name                       | Type     | Description                                                 |
| -------------------------- | -------- | ----------------------------------------------------------- |
| wallet\_address            | str      | Address of the whale wallet being monitored.                |
| predicted\_movement        | str      | Predicted movement type (e.g., "Accumulation," "Sell-off"). |
| confidence\_score          | float    | AI-generated confidence score for the prediction.           |
| market\_impact\_estimation | float    | Projected market impact (% price change).                   |
| timestamp                  | datetime | Timestamp of the prediction.                                |

***

**Key Features**

* **Behavioral Pattern Analysis:** Leverages historical behavior to predict future wallet movements.
* **Market Impact Estimation:** Calculates the potential impact of whale movements on token price and liquidity.
* **Customizable Prediction Windows:** Flexible time horizons for users to adapt predictions to their strategy.
* **AI-Driven Confidence Scores:** Provides clarity on the reliability of each prediction.


---

# 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.satoshiterminal.io/resources/copy-of-defi-analytics/insights-and-predictive-analytics/predictive-whale-movement-analysis.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.