---
title: "Get tips received aggregated across all linked wallets"
method: GET
path: "/v1/account/earnings/tips"
tags: ["account"]
---

# Get tips received aggregated across all linked wallets

`GET /v1/account/earnings/tips`

Get tips received by the authenticated account.

This aggregates tips received across ALL wallets linked to your account.
Each entry shows which wallet received the tip via `earning_address`.

Sort options:
- `recent`: Newest tips first (by confirmed_at DESC)
- `top`: Highest amount first (by amount_usd DESC)

Authentication: `Authorization: Bearer <CLIENT_JWT>`

## Query parameters

- `limit` integer — Maximum number of tips to return (default: 10, max: 50).
- `sort` string — Sort order: 'recent' (newest first) or 'top' (highest amount first).

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove that identifies the account.

## Response `200`

Successful Response

- TipsReceivedResponse — Response model for tips received by an address.
  - `entries` TipReceivedEntry[], required
    - `id` string, required
    - `amount_usd` string, required
    - `confirmed_at` string, required
    - `tipper_address` string, required
    - `context` TipContextResponse — Social graph context attached to a tip (response model). This is the output version of TipContext - no validation needed since it's read from the database. All fields are optional as tips may have partial or no context.
      - `source_post_url` string, nullable
      - `sender_username` string, nullable
      - `sender_profile_url` string, nullable
      - `sender_platform` string, nullable
      - `sender_grove_handle` string, nullable
      - `recipient_username` string, nullable
      - `recipient_profile_url` string, nullable
      - `recipient_grove_handle` string, nullable
      - `campaign` string, nullable
      - `referrer` string, nullable
      - `custom_metadata` string, nullable
      - `is_discrete_giveaway_entry` boolean
      - `is_paid_message` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/versions/f286b48a8105/schema)