Skip to content

Add wallet activity feed endpoint for full trade history across all creators #424

@Chucks1093

Description

@Chucks1093

Summary

A fan who has been active on the platform — buying and selling keys across multiple creators — has no way to review their own history. They need a single endpoint that shows every trade their wallet has made in chronological order, across all creators, so they can track their activity, calculate their own returns, and understand their trading patterns.

Scope

  • Add GET /wallets/:address/activity endpoint
  • Returns paginated list of trade events: { type (buy|sell), creator_id, creator_handle, amount, price_at_trade, fee_paid, ledger_sequence, timestamp }
  • Default sort is most recent first
  • Support type filter param to show only buys or only sells
  • Support creator_id filter param to see activity for a specific creator only
  • Data is sourced from the indexed trade event history

Acceptance Criteria

  • Returns all buy and sell events for the wallet in reverse chronological order
  • Each event includes the price and fee at the time of the trade (not current price)
  • type=buy or type=sell filter returns only matching events
  • creator_id filter returns only trades for that creator
  • Returns empty array (not 404) for a valid wallet with no activity
  • Returns 400 for a malformed Stellar address
  • Pagination works correctly across large trade histories
  • Integration test covers: mixed history, type filter, creator filter, empty wallet

Coordinate on Telegram

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions