📊 Feat: NFT Analytics & Aggregation Service

[Cedarich]

Title: feat(analytics): implement collection stats and floor price history
Complexity Score: 200 points

Description
Provide historical data analysis for collections, such as volume over time, floor price trends, and holder distribution.

Requirements and Context

• Entities: CollectionStats (date, volume, floor_price, sales_count).
• Aggregation: A scheduled job should calculate these stats daily/hourly from the Sales history.
• API: Endpoints to fetch charts data (e.g., [timestamp, value]).

Suggested Execution

1. Create AnalyticsService.
2. Implement a Cron job that runs at midnight.
3. Query the Sale entity to sum volumes and find min price for each collection.
4. Save results to CollectionStats.
5. Expose GET /collections/:id/stats.

Test and Commit

• Test aggregation logic with mock sales data.
• Commit Message: feat(analytics): implement collection stats and floor price history

---

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[rosemary21]

@rosemary21 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

I’d love to work on this issue because analytics is where product value really becomes visible to users. Collection-level insights like volume over time, floor price trends, and holder distribution directly impact user decision-making and platform engagement. Implementing a reliable aggregation pipeline for this data is both technically interesting and strategically important.

This task is especially appealing because it sits at the intersection of backend engineering, data modeling, and performance optimization. Designing a scheduled aggregation job that computes metrics from raw Sale records into a structured CollectionStats entity requires careful thinking around

ℹ️ Repo Maintainers: To accept this application, review their application or assign @rosemary21 to this issue.

[Agbasimere]

@Agbasimere has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Can I work on this?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Agbasimere to this issue.