---
title: "Get tips received by an address"
method: GET
path: "/v1/earnings/{address}/tips"
tags: ["earnings"]
---

# Get tips received by an address

`GET /v1/earnings/{address}/tips`

Get tips received by a wallet address (public, no auth).

Returns individual tip events with sender information and social context.

- `sort` options:
    - `recent`: ordered by confirmed_at DESC (newest first)
    - `top`: ordered by amount_usd DESC (highest first)

## Path parameters

- `address` string, required

## Query parameters

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

## 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)