Skip to main content
Tip Stack’s analytics panel gives you a clear picture of how your earnings and supporter base are growing over time. You can see total lifetime metrics at a glance, drill into daily tip volume trends on a line chart, compare fiat vs. crypto breakdowns on a donut chart, and see who your most loyal supporters are — all without leaving your dashboard. This page explains each metric, how the time-series data is structured, how supporter addresses are handled for privacy, and how to use the underlying API for custom integrations.
Analytics data updates in real time as tips are confirmed on-chain. There is no manual refresh needed — the dashboard polls for new confirmed tips automatically.

Summary metrics

Four headline stats appear at the top of the Analytics panel. Each value is calculated across all confirmed tips on your account since creation.

Avg. Tip Size

Total USDC volume divided by total tip count. Helps you understand how much supporters typically send per tip.

Total Tips

The count of all confirmed on-chain tips received, regardless of token type or amount.

This Week

Number of confirmed tips received in the last 7 days. Useful for tracking recent momentum.

Biggest Tip

The single largest USDC-equivalent tip you’ve ever received, highlighted in green.
The full-lifetime summary is also available via the analytics API and includes:
MetricAPI field
Unique supporterssummary.uniqueSupporters
Total tip countsummary.totalTips
Total volume (USDC)summary.totalVolume
Average tip sizesummary.avgTipSize

Earnings over time (time-series chart)

The Earnings Over Time line chart plots your daily USDC tip volume over a selected date range. The x-axis shows dates and the y-axis shows USD amounts. Hover over any data point to see the exact daily earnings figure.
  • The default view covers the last 30 days.
  • You can request any range from 1 to 365 days using the ?days= query parameter on the API (see API usage below).
  • Daily data points are aggregated server-side and sorted chronologically before being returned.
  • Days with no tips may be absent from the API time series and render as zero on the chart.

Fiat vs. crypto breakdown

A donut chart below the time-series breaks your earnings into two segments:
SegmentColorDescription
Crypto (USDC/SOL)GreenTips paid in USDC or SOL via the crypto checkout.
Fiat (NGN)OrangeTips paid in Nigerian naira via the fiat checkout, converted to USDC equivalent.
This breakdown helps you understand which payment method your audience prefers so you can optimize how you promote your tipping link.

Top supporters leaderboard

The Top Supporters panel lists the five supporters who have sent you the most total USDC (all time), ranked by cumulative tip volume.
  • Rank 1–3 are shown with gold, silver, and bronze badges (🥇 🥈 🥉).
  • Ranks 4–5 show a numeric label.
  • Each row shows the supporter’s identifier and their total contribution in USD.
Privacy masking: Wallet addresses longer than 20 characters are automatically truncated to show only the first 4 and last 4 characters, separated by .... For example, AaBbCcDdEe...FfGgHhIi. This applies both in the dashboard and in API responses. Supporters who tipped with a registered Tip Stack username display their username in full (since it’s a public, self-chosen identifier).

API usage

Tip Stack exposes a GET /creators/analytics endpoint that powers the dashboard panel. You can query it directly for custom reporting, spreadsheet exports, or third-party integrations.

Endpoint

GET /api/creators/analytics
Authentication is required (Bearer token from your session).

Query parameters

ParameterTypeDefaultDescription
daysinteger30Number of days to include in the time series. Clamped to the range 1–365.

Example request

curl -X GET "https://tipstack.fun/api/creators/analytics?days=90" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Example response

{
  "success": true,
  "data": {
    "summary": {
      "uniqueSupporters": 42,
      "totalTips": 187,
      "totalVolume": 534.20,
      "avgTipSize": 2.86
    },
    "timeSeries": [
      { "date": "2025-04-01", "amount": 12.50 },
      { "date": "2025-04-02", "amount": 8.00 }
    ],
    "topSupporters": [
      { "name": "AaBb...HhIi", "total_amount": "75.00", "tip_count": "12" },
      { "name": "mycreator", "total_amount": "50.00", "tip_count": "8" }
    ]
  }
}

Using the ?days= parameter

The days parameter controls how far back the time-series data reaches. Setting days=7 returns the last 7 days of data; days=365 returns a full year. Values outside the 1–365 range are automatically clamped to the nearest boundary.
# Last 7 days
GET /api/creators/analytics?days=7

# Last 365 days
GET /api/creators/analytics?days=365
The timeSeries array is sorted chronologically (date ASC) and only includes dates within the requested range that have at least one confirmed tip recorded. Use days=365 when building annual earnings reports or year-in-review content.

Frequently asked questions

The analytics panel calculates totals from confirmed on-chain tips only. Your dashboard balance may differ if there are pending tips still awaiting confirmation, or if some tips were sent in SOL and converted to a USDC equivalent for display purposes.
Use the /api/creators/analytics?days=365 endpoint to fetch a full year of time-series data in JSON, then import it into Google Sheets or Excel using the JSON import feature. The timeSeries array maps directly to a date/amount table.
Tips sent without a linked account are grouped together under the label “Anonymous” in the top supporters calculation. If Anonymous tips make up a significant share of your earnings, they appear as a single aggregated row in the leaderboard.
Yes. Analytics are tied to your account, not your public handle. Changing your handle does not affect historical tip data or analytics.
“This Week” counts individual confirmed tip events (transactions) in the last 7 calendar days, not unique supporters. A single supporter who tips 5 times in a week contributes 5 to this number.