# bhardwajtanuj/trader-sentiment-analysis architecture

> Architecture diagram of the GitHub repository bhardwajtanuj/trader-sentiment-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bhardwajtanuj/trader-sentiment-analysis
- Repository: https://github.com/bhardwajtanuj/trader-sentiment-analysis

## Overview

This repository presents a notebook-based analysis of how Bitcoin market sentiment relates to Hyperliquid trader behavior and performance. The documented workflow aligns both datasets by trade date, cleans and enriches trade records, compares performance and positioning across sentiment categories, and turns those findings into behavioral insights and risk-management recommendations. The README documents these stages, but no notebook source excerpts were provided, so the graph does not claim particular code-level calls or implementation details.

Main entry points: [`analysis_final.ipynb`](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb) (Merge by trade date)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Data inputs"]
  node_sentiment_data["Fear &amp; Greed data"]
  node_trader_data["Hyperliquid trade data"]
end

subgraph group_analysis["Trade analysis"]
  node_notebook["Analysis notebook"]
  node_preprocessing["Clean and preprocess"]
  node_date_merge["Merge by trade date"]
  node_features["Engineer trade features"]
  node_summary["Sentiment summary"]
  node_visualizations["Seven EDA graphs"]
end

subgraph group_findings["Insights and recommendations"]
  node_behavior["Behavioral insights"]
  node_recommendations["Trading recommendations"]
end

node_analyst(("Analyst"))

node_analyst -->|"runs analysis"| node_notebook
node_sentiment_data -->|"provides sentiment"| node_date_merge
node_trader_data -->|"provides trades"| node_date_merge
node_notebook -->|"performs"| node_preprocessing
node_preprocessing -->|"precedes merge"| node_date_merge
node_date_merge -->|"enables"| node_features
node_features -->|"supports"| node_summary
node_summary -->|"compares"| node_visualizations
node_visualizations -->|"informs"| node_behavior
node_behavior -->|"guides"| node_recommendations

click node_notebook "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"
click node_preprocessing "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"
click node_date_merge "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"
click node_features "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"
click node_summary "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"
click node_visualizations "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"
click node_behavior "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"
click node_recommendations "https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sentiment_data,node_trader_data toneBlue
class node_notebook,node_preprocessing,node_date_merge,node_features,node_summary,node_visualizations toneAmber
class node_behavior,node_recommendations toneMint
class node_analyst toneIndigo
```

## Components

### Data inputs

- **Fear & Greed data**
- **Hyperliquid trade data**

### Trade analysis

- [Analysis notebook](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`
- [Clean and preprocess](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`
- [Merge by trade date](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`
- [Engineer trade features](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`
- [Sentiment summary](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`
- [Seven EDA graphs](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`

### Insights and recommendations

- [Behavioral insights](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`
- [Trading recommendations](https://github.com/bhardwajtanuj/trader-sentiment-analysis/blob/main/analysis_final.ipynb): `analysis_final.ipynb`

### Other components

- **Analyst**

## Connections

- Analyst → Analysis notebook: runs analysis (evidence: `README.md`)
- Fear & Greed data → Merge by trade date: provides sentiment (evidence: `README.md`)
- Hyperliquid trade data → Merge by trade date: provides trades (evidence: `README.md`)
- Analysis notebook → Clean and preprocess: performs (evidence: `README.md`)
- Clean and preprocess → Merge by trade date: precedes merge (evidence: `README.md`)
- Merge by trade date → Engineer trade features: enables (evidence: `README.md`)
- Engineer trade features → Sentiment summary: supports (evidence: `README.md`)
- Sentiment summary → Seven EDA graphs: compares (evidence: `README.md`)
- Seven EDA graphs → Behavioral insights: informs (evidence: `README.md`)
- Behavioral insights → Trading recommendations: guides (evidence: `README.md`)
