Skip to main content
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
address
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.

Response

success
boolean
true when the query completed successfully.
tips
array
Array of tip objects ordered by timestamp descending. Maximum 50 results.

Example request

cURL
curl "https://tipstack.fun/api/solana/tips?address=monalisa.sol"

Example response

JSON
{
  "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
      }
    }
  ]
}
Results include pending fiat intents (status pending) alongside confirmed on-chain tips. Filter by status === "confirmed" if you only want to display settled tips.
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.