---
title: "Stats Settlements Endpoint"
method: GET
path: "/stats/settlements"
tags: ["statistics"]
---

# Stats Settlements Endpoint

`GET /stats/settlements`

## Request

- Base URL: `https://api.sumvid.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sumvid.app/stats/settlements`
- Auth: none declared

Public settlements feed for the frontend `/settlements` page: recent
settled x402 payments (sanitized), plus all-time totals and a 30-day
daily series. Reads `x402_payments` directly (settled rows only), unlike
the job-ledger-derived aggregates above. Cached ~10s, near-live.

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- PublicSettlementsFeed
  - `totals` PublicSettlementTotals, required
    - `settled_count` integer, required
    - `settled_amount_atomic` string, required
    - `distinct_payers` integer, required
    - `settled_last_24h` integer, required
    - `last_settled_at` string, date-time, nullable
  - `settlements` PublicSettlementRow[], required
    - `id` integer, required
    - `sku` string, required
    - `surface` string, required
    - `network` string, nullable
    - `amount_atomic` string, required
    - `payer_short` string, required
    - `tx_hash` string, nullable
    - `settled_at` string, date-time, required
    - `created_at` string, date-time, required
    - `youtube_video_id` string, nullable
    - `title` string, nullable
    - `channel` string, nullable
    - `served_from_cache` boolean, nullable
  - `daily` PublicSettlementDailyPoint[], required
    - `day` string, date, required
    - `settled_count` integer, required
    - `settled_amount_atomic` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sumvid/apis/summarize-vid.md) · [All operations](https://skmtc.dev/sumvid/apis/summarize-vid/llms.txt) · [OpenAPI document](https://skmtc.dev/sumvid/apis/summarize-vid/revisions/c03d66e07deb?raw)