# Private Key Behavior Analysis

**Implementation Details**

**Class Names**

| Model Name                 | Parameters Class              | Data Class             |
| -------------------------- | ----------------------------- | ---------------------- |
| PrivateKeyBehaviorAnalysis | PrivateKeyBehaviorQueryParams | PrivateKeyBehaviorData |

**Import Statement**

```python
pythonCopyEditfrom satoshi_terminal.models.private_key_behavior_analysis import (
    PrivateKeyBehaviorAnalysis,
    PrivateKeyBehaviorQueryParams,
    PrivateKeyBehaviorData,
)
```

***

**Parameters**

| Name            | Type                    | Description                                                             | Default | Optional |
| --------------- | ----------------------- | ----------------------------------------------------------------------- | ------- | -------- |
| wallet\_address | Union\[str, List\[str]] | Address(es) of wallets associated with private keys to monitor.         | None    | False    |
| activity\_scope | str                     | Scope of behavior analysis (e.g., "Transfers," "Smart Contract Calls"). | None    | True     |
| time\_horizon   | int                     | Time window (in days) for monitoring private key activities.            | 30      | True     |

***

**Data**

| Name                        | Type     | Description                                       |
| --------------------------- | -------- | ------------------------------------------------- |
| wallet\_address             | str      | Wallet address being analyzed.                    |
| anomalous\_behavior         | bool     | Indicates whether unusual activity was detected.  |
| key\_activity\_distribution | dict     | Breakdown of private key usage by activity type.  |
| risk\_score                 | float    | Risk score (0-100) based on behavioral anomalies. |
| timestamp                   | datetime | Timestamp of the analysis.                        |

***

**Key Features**

* **Anomalous Behavior Detection:** Flags unusual or suspicious private key activity.
* **Activity Distribution Insights:** Provides a breakdown of actions initiated by private keys.
* **Risk Scoring:** Quantifies the risk associated with private key behaviors for enhanced security.


---

# 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/risk-management-and-security-analytics/private-key-behavior-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.