Add REST Route: Get Current User Usage and Stats

[greatest0fallt1me]

Description
Implement GET /api/usage (authenticated): query params (from, to, limit). Return usage events for the current user (from JWT), total spent in period, and optional breakdown by API. Use usage_events repository and requireAuth.

Requirements and context

• Must require wallet auth (JWT)
• Default period: current month or last 30 days

Suggested execution

• Fork the repo and create a branch
• git checkout -b feature/rest-user-usage
• Implement changes
  • Route GET /api/usage with requireAuth; validate query; return events and aggregates
  • Add tests
• Test and commit
  • Run tests
  • Example commit message: feat: REST user usage and stats

Guidelines

• Clear documentation
• Timeframe: 96 hours
• Project details: #

[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

[devcarole]

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

I would like to work on this issue because providing users with usage stats improves transparency and monitoring. I can implement the GET /api/usage route with JWT authentication, validate query params, return usage events and aggregates from the repository, and add tests to ensure correct behavior.

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

[Osuochasam]

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

Dear maintainer, Assign me this issue an i will resolve it

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

[drips-wave]

Congratulations, @devcarole! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on February 26, 2026.

🧑‍💻 @devcarole: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[Adeswalla]

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

Hello Maintainter,
I would like to apply to this issue and work on it because as a Javascript and Typescript i prioritize functional and production-level code.

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

[devcarole]

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

I would like to work on this issue because providing users with detailed usage stats improves transparency and monitoring. I can implement the authenticated GET /api/usage route, validate query parameters, fetch events from the usage_events repository, return totals and API breakdowns, and add tests to ensure correctness.

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

[ryzen-xp]

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

Hi maintainers 👋
I’m a blockchain developer with strong expertise in Stellar, Rust,TS and Stellar SDK integrations. I’ve worked on multiple Stellar-based smart contract and backend systems.

I understand the scope of this issue and can deliver a reliable, production-quality solution with proper tests and documentation.
Plz assign me !!

ETA: 4 hours

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

[rosemary21]

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

Is something i can quickly resolve before deadline .I’d be happy to work on this issue because it directly impacts user transparency and billing clarity — two critical aspects of any usage-based platform. A well-implemented improves trust by clearly showing users their activity and spending, while also reinforcing secure wallet-based authentication boundaries.

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