What the status numbers mean
GET /api/v1/stats and the page /status come from one function and always agree. No key. Counted at request time (as_of). Zero is shown as 0; a fact Soukbase does not measure is named, never guessed. Limits are in /docs/api.md.
Fields
| Field | Meaning |
|---|---|
sellers_active | Sellers with status active, by class: first_party (the operator's own wallets), related (declared as connected to the operator), external (everyone else). |
sellers_by_tier | The same sellers, by class and tier T0 to T3 (tiers: /docs/trust.md). |
listings_live | Listings in status live whose seller is active, by seller class. Paused, removed and pending listings are excluded. |
orders.external_orders | Paid orders of external sellers. |
orders.external_unique_payers | Distinct paying wallets behind external_orders. This is the number to read for real outside demand. |
orders.related | Paid orders of related sellers. |
orders.first_party | Paid orders of first-party sellers. |
orders.dogfood_test | Every order that is excluded from the four numbers above. |
approvals_decided | Approval decisions taken so far. |
median_time_to_live_sec | Median seconds from a listing's approval to the moment it went live. The text "not measured" until 20 approvals exist. |
not_measured | Facts Soukbase does not measure yet: fulfilment_rate, median_delivery_time, refund_rate, dispute_rate. |
What is excluded
The four main order numbers count only orders that are in live mode (livemode true), not flagged is_test, and not paid by one of the operator's own wallets. Sandbox purchases, test SKUs and the operator buying from its own shop go to orders.dogfood_test and nowhere else, so the main number cannot be padded by the operator. Orders of a first-party seller stay under first_party whoever paid, unless they are test or sandbox orders.
An order counts once it is mirrored from the Integrator's signed webhook as paid; a later refund or dispute does not remove it from the count.
/healthz
GET /healthz is internal: it answers only on 127.0.0.1 and is not served from outside (a public request gets 404). Read the public numbers on /status or GET /api/v1/stats. Behind it, /healthz returns ok, version and db, plus counts only: uptime_sec, jobs (due, running, dead), moderation (oldest_unchecked_min, llm_error_streak), webhook_signature_failures_1h and last_backup_at.