v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
account

Get account tip history

Retrieve the tip history for the authenticated account.

Returns a paginated list of all tip events where this account was either the sender or recipient, ordered by most recent first.

Each entry includes:

  • direction: "sent" if you sent the tip, "received" if you received it
  • counterparty_address: The wallet address of the other party
  • destination: Original tip destination (e.g., "x.com/username")
  • tip_social_graph: Source type ("x", "reddit", "github", "tiktok", "substack", "youtube", "website", "unknown")

Authentication: Authorization: Bearer <CLIENT_JWT>

Query parameters:

  • limit: Maximum number of events to return (default: 50, max: 100)
  • offset: Number of events to skip for pagination (default: 0)
get/v1/account/tip_history

Query parameters

limitinteger

Maximum number of events to return

Maximum number of events to return

offsetinteger

Number of events to skip for pagination

Number of events to skip for pagination

Headers

authorizationstring nullable

Bearer JWT issued by Grove that identifies the account.

Bearer JWT issued by Grove that identifies the account.

Response

Successful Response

account_idstring required
total_countinteger required