v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

Get earnings summary aggregated across all linked wallets

Get aggregated earnings summary for the authenticated account.

This aggregates tips received across ALL wallets linked to your account:

  • Server wallet (Grove-managed, for sending tips)
  • EOA wallet (user-controlled, for earning tips)
  • Any external linked wallets (verified via signature)

Use window to filter by time period:

  • 24h: Last 24 hours
  • 7d: Last 7 days
  • 30d: Last 30 days
  • all: All time (default)

Authentication: Authorization: Bearer <CLIENT_JWT>

get/v1/account/earnings/summary

Query parameters

windowstring

Time window: '24h', '7d', '30d', or 'all' (lifetime).

Time window: '24h', '7d', '30d', or 'all' (lifetime).

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Response

Successful Response

total_usdstring required
tip_countinteger required
unique_tipper_countinteger required