---
title: "Admin revenue feed (Paddle + x402)"
method: GET
path: "/v5/revenue-pulse"
tags: ["Operations"]
---

# Admin revenue feed (Paddle + x402)

`GET /v5/revenue-pulse`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/revenue-pulse`
- Auth: none declared. Required headers: `X-Oracle-Key`

Admin only — requires MASTER_API_KEY in X-Oracle-Key header. Returns Paddle lifetime counts (by tier), x402 lifetime stats, and the most recent 50 Paddle revenue events from KV (30-day TTL). Consumed by .github/workflows/health-check.yml to surface new revenue as GitHub issues.

## Headers

- `X-Oracle-Key` string, required

## Response `200`

Revenue pulse

- object
  - `paddle` object
  - `x402` object

## Other responses

- `401`: Missing or invalid master key

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)