---
title: "Get account tip history"
method: GET
path: "/v1/account/tip_history"
tags: ["account"]
---

# Get account tip history

`GET /v1/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)

## Query parameters

- `limit` integer — Maximum number of events to return
- `offset` integer — Number of events to skip for pagination

## Headers

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

## Response `200`

Successful Response

- TipHistoryResponse — Response model for account tip history.
  - `account_id` string, required
  - `total_count` integer, required
  - `entries` TipHistoryEntry[], required
    - `id` string, required
    - `tx_hash` string, nullable
    - `amount_usd` string, required
    - `amount_raw` string, required
    - `token_symbol` string, required
    - `network` string, required
    - `status` string, required
    - `created_at` string, required
    - `confirmed_at` string, nullable
    - `direction` string, required
    - `counterparty_address` string, required
    - `counterparty_account_id` string, nullable
    - `earning_address` string, nullable
    - `destination` string, nullable
    - `tip_social_graph` string, nullable
    - `fee_amount` string, nullable
    - `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)