> ## 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.

# Track Your Tip Stack Earnings, Tips, and Supporter Growth

> Use Tip Stack's analytics dashboard to view tip trends, top supporters, daily volume, and total earnings over any time period up to 365 days.

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.

<Info>
  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.
</Info>

***

## 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.

<CardGroup cols={4}>
  <Card title="Avg. Tip Size" icon="chart-line">
    Total USDC volume divided by total tip count. Helps you understand how much supporters typically send per tip.
  </Card>

  <Card title="Total Tips" icon="gift">
    The count of all confirmed on-chain tips received, regardless of token type or amount.
  </Card>

  <Card title="This Week" icon="calendar">
    Number of confirmed tips received in the last 7 days. Useful for tracking recent momentum.
  </Card>

  <Card title="Biggest Tip" icon="trophy">
    The single largest USDC-equivalent tip you've ever received, highlighted in green.
  </Card>
</CardGroup>

The full-lifetime summary is also available via the analytics API and includes:

| Metric              | API field                  |
| ------------------- | -------------------------- |
| Unique supporters   | `summary.uniqueSupporters` |
| Total tip count     | `summary.totalTips`        |
| Total volume (USDC) | `summary.totalVolume`      |
| Average tip size    | `summary.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](#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:

| Segment               | Color  | Description                                                                      |
| --------------------- | ------ | -------------------------------------------------------------------------------- |
| **Crypto (USDC/SOL)** | Green  | Tips paid in USDC or SOL via the crypto checkout.                                |
| **Fiat (NGN)**        | Orange | Tips 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

| Parameter | Type    | Default | Description                                                               |
| --------- | ------- | ------- | ------------------------------------------------------------------------- |
| `days`    | integer | `30`    | Number of days to include in the time series. Clamped to the range 1–365. |

### Example request

```bash theme={null}
curl -X GET "https://tipstack.fun/api/creators/analytics?days=90" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"
```

### Example response

```json theme={null}
{
  "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.

```bash theme={null}
# Last 7 days
GET /api/creators/analytics?days=7

# Last 365 days
GET /api/creators/analytics?days=365
```

<Tip>
  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.
</Tip>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Why does my total volume in analytics differ from my dashboard balance?">
    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.
  </Accordion>

  <Accordion title="Can I export my analytics data to a spreadsheet?">
    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.
  </Accordion>

  <Accordion title="How are anonymous tips handled in the leaderboard?">
    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.
  </Accordion>

  <Accordion title="Is historical data retained if I change my handle?">
    Yes. Analytics are tied to your account, not your public handle. Changing your handle does not affect historical tip data or analytics.
  </Accordion>

  <Accordion title="What does 'This Week' count — tip events or unique supporters?">
    "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.
  </Accordion>
</AccordionGroup>