GET /sdk/events — Fetch Verified SDK Tip Events

Poll this endpoint to receive a stream of confirmed tip events for a creator. The response includes on-chain details for each tip — token symbol, amount, sender wallet, and Solana transaction signature — so you can trigger rewards, update dashboards, or fan out notifications without subscribing to a WebSocket.

Only tips with status "confirmed" are returned. Tips pending on-chain confirmation will not appear.

Endpoint

GET https://tipstack.fun/api/sdk/events

Authentication

Pass your API key as a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Query Parameters

string

required

The creator’s UUID (as returned in config.creatorId from /sdk/init). The endpoint returns only tips belonging to this creator.

string

An ISO 8601 datetime string (e.g. 2024-06-01T12:00:00.000Z). When provided, only tips with a timestamp strictly after this value are returned. Use this to implement incremental polling without re-processing old events.

Response

boolean

true when the request completed successfully.

array

An array of up to 50 tip event objects, ordered by timestamp descending (most recent first).

Show Event object fields

string

The Solana transaction signature for this tip. Identical to txSignature — use either as a stable, unique identifier.

string

Always "tip_completed" for confirmed on-chain tips.

number

The tip amount denominated in USDC. This field is populated only when tokenSymbol is "USDC"; otherwise it is 0.

number

The raw tip amount in the token’s native units. Use this field when tokenSymbol is "SOL" or any non-USDC token.

string

The token used for the tip — for example, "SOL" or "USDC".

string

The supporter’s Solana wallet address.

string

ISO 8601 datetime string indicating when the tip was confirmed on-chain.

string

The Solana transaction signature. You can look this up on Solscan or Explorer to verify the transaction independently.

Polling Pattern

For lightweight integrations, poll this endpoint at a regular interval — typically every 30–60 seconds. Pass the timestamp of the most recently processed event back as the since parameter to receive only new tips on each call.

Poll events example

const lastSeen = new Date(Date.now() - 60_000).toISOString();
const res = await fetch(
  `https://tipstack.fun/api/sdk/events?creatorId=YOUR_CREATOR_ID&since=${lastSeen}`,
  { headers: { Authorization: 'Bearer YOUR_API_KEY' } }
);
const { events } = await res.json();

Store the timestamp of the last event you successfully processed in persistent storage (e.g. a database or Redis key). On restart, resume polling from that value to avoid replaying old events or missing any tips that arrived while your service was down.

Example

Request

curl "https://tipstack.fun/api/sdk/events\
?creatorId=f47ac10b-58cc-4372-a567-0e02b2c3d479\
&since=2024-06-01T12:00:00.000Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "events": [
    {
      "eventId": "5KtGhJ2mNpQrVwXyZabc1234defg5678hijkLMNO9012pqrs",
      "type": "tip_completed",
      "amountUsdc": 5.00,
      "amountRaw": 5.00,
      "tokenSymbol": "USDC",
      "sender": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "timestamp": "2024-06-01T13:42:07.000Z",
      "txSignature": "5KtGhJ2mNpQrVwXyZabc1234defg5678hijkLMNO9012pqrs"
    },
    {
      "eventId": "3AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcdefghij",
      "type": "tip_completed",
      "amountUsdc": 0,
      "amountRaw": 0.25,
      "tokenSymbol": "SOL",
      "sender": "9aBcDeFgHiJkLmNoPqRsTuVwXyZ1234567890abcdefghij",
      "timestamp": "2024-06-01T12:18:33.000Z",
      "txSignature": "3AbCdEfGhIjKlMnOpQrStUvWxYz0123456789abcdefghij"
    }
  ]
}

Error Responses

Status	Error	Cause
`400 Bad Request`	`"creatorId is required"`	The `creatorId` query parameter is missing.
`401 Unauthorized`	`"Missing or invalid API key"`	The `Authorization` header is absent or malformed.
`500 Server Error`	`"Failed to fetch verified events"`	An unexpected server error occurred.

Overview

Payments

Tips

SDK

Payouts

GET /sdk/events — Fetch Verified SDK Tip Events

Endpoint

Authentication

Query Parameters

Response

Polling Pattern

Example

Request

Response

Error Responses

​Endpoint

​Authentication

​Query Parameters

​Response

​Polling Pattern

​Example

​Request

​Response

​Error Responses

Endpoint

Authentication

Query Parameters

Response

Polling Pattern

Example

Request

Response

Error Responses