> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tipstack.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tips for a Creator Wallet — GET /solana/tips

> Retrieve confirmed tip records for a Tip Stack creator, ordered by most recent. Returns sender, amount, token, message, and on-chain signature.

Retrieve up to 50 of the most recent tip records associated with a creator. Results include both confirmed on-chain tips and pending fiat payment intents, ordered newest-first. Each tip includes the on-chain signature (or fiat intent ID), sender details, token amount, USD equivalent, and any message from the supporter.

## Request

**`GET https://tipstack.fun/api/solana/tips`**

<ParamField query="address" type="string" required>
  The creator identifier to query. Accepts a Solana wallet address (base58), Tip Stack user ID, or `.sol` domain. Tips are matched against the creator's wallet address, linked user ID, or both.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  `true` when the query completed successfully.
</ResponseField>

<ResponseField name="tips" type="array">
  Array of tip objects ordered by `timestamp` descending. Maximum 50 results.

  <Expandable title="tip object fields">
    <ResponseField name="signature" type="string">
      The Solana transaction signature for on-chain tips, or the `fossa_xxx` intent ID for fiat tips. Use this as the unique identifier for each tip.
    </ResponseField>

    <ResponseField name="recipient" type="string">
      The creator's wallet address.
    </ResponseField>

    <ResponseField name="recipient_id" type="string | null">
      The Tip Stack user ID of the creator, if registered.
    </ResponseField>

    <ResponseField name="sender" type="string">
      The sender's wallet address for crypto tips, or the supporter's display name for fiat tips.
    </ResponseField>

    <ResponseField name="sender_id" type="string | null">
      The Tip Stack user ID of the sender, if registered.
    </ResponseField>

    <ResponseField name="amount" type="number">
      The tip amount in human-readable units (e.g. `0.1` for 0.1 SOL, `5.00` for 5 USDC).
    </ResponseField>

    <ResponseField name="tokenSymbol" type="string">
      The token symbol: `SOL`, `USDC`, `USDT`, `BONK`, `FIAT`, etc. Fiat tips use the symbol `FIAT`.
    </ResponseField>

    <ResponseField name="message" type="string | null">
      The supporter's message, if provided.
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO 8601 timestamp of when the tip was recorded.
    </ResponseField>

    <ResponseField name="status" type="string">
      `pending`, `confirmed`, `failed`, or `cancelled`.
    </ResponseField>

    <ResponseField name="valueUsd" type="number">
      Estimated USD value at time of tip. Stablecoin and fiat tips use their face value; SOL tips are converted using the current SOL/USD price.
    </ResponseField>

    <ResponseField name="isStable" type="boolean">
      `true` when the tip was in a stablecoin (USDC, USDT) or fiat currency.
    </ResponseField>

    <ResponseField name="fiatDetails" type="object | null">
      Present only for fiat tips. Contains `platformFee`, `finalAmountUsd`, and `amountNgn` from the original intent.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example request

```bash cURL theme={null}
curl "https://tipstack.fun/api/solana/tips?address=monalisa.sol"
```

## Example response

```json JSON theme={null}
{
  "success": true,
  "tips": [
    {
      "signature": "5UfgJ9H7Kp2mRd8NqWx4vYzA1bEc3sFt6LiOoP7rTkVhXy8wMnCjDuZe0pQaBcI",
      "recipient": "9xRT3m1KZJPHQQaFGpvDJckJcNhHMbDdBfHHVdFGQS7b",
      "recipient_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "sender": "8xRT3m1KZJPHQQaFGpvDJckJcNhHMbDdBfHHVdFGQS7a",
      "sender_id": null,
      "amount": 0.1,
      "tokenSymbol": "SOL",
      "message": "Keep up the great work!",
      "timestamp": "2025-01-15T14:30:00.000Z",
      "status": "confirmed",
      "valueUsd": 19.43,
      "isStable": false,
      "fiatDetails": null
    },
    {
      "signature": "fossa_7c3e9a1b2f4d8e0a6c5b",
      "recipient": "9xRT3m1KZJPHQQaFGpvDJckJcNhHMbDdBfHHVdFGQS7b",
      "recipient_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "sender": "John Doe",
      "sender_id": null,
      "amount": 9.5,
      "tokenSymbol": "FIAT",
      "message": "Great stream today!",
      "timestamp": "2025-01-15T13:15:00.000Z",
      "status": "confirmed",
      "valueUsd": 9.5,
      "isStable": true,
      "fiatDetails": {
        "platformFee": 0.5,
        "finalAmountUsd": 9.5,
        "amountNgn": 14250
      }
    }
  ]
}
```

<Info>
  Results include pending fiat intents (status `pending`) alongside confirmed on-chain tips. Filter by `status === "confirmed"` if you only want to display settled tips.
</Info>

<Note>
  Tips from both directions are returned — as recipient and as sender — for the queried address. Filter by `recipient` if you only want tips the creator received.
</Note>