SOLWYN
Commands

overview

Calendar-month spend and request totals across every project in the account, with savings and the included-request quota

overview is the account-wide counterpart to the project-scoped status: this calendar month's total spend, total requests, project count, and trend against last month, plus the savings hard-deny produced and, on the Free tier, the included-request quota. It requires a user login; a project key exits 3 before any request. There are no options and no --project.

Terminal
$ solwyn overview
Metric                                                      Value
Period                                    2026-09-01 - 2026-09-30
Total spend                                            $42.500000
Total requests                                               5100
Projects                                                        3
Trend vs last period                                      +12.50%
Savings                                                 $4.250000
Savings upper                                                   —
Saved input tokens                                          12000
Blocked calls                                                   6
Quota exceeded                                                yes
Quota requests                                        5100 / 5000
Quota window          2026-09-01T00:00:00Z - 2026-10-01T00:00:00Z
Contract
AuthJWT
Exit codes0 success · 1 generic/API · 3 auth
JSON schemasolwyn.overview.v1
RowMeaning
Trend vs last periodSpend relative to the previous calendar month, as a signed percentage.
Savings / Savings upper / Saved input tokens / Blocked callsWhat hard_deny budgets prevented: the cost of blocked calls, an upper bound when one is known, and their input tokens. Shown only when the account reports savings.
Quota exceededWhether the account has passed its included requests for the period. Always shown.
Quota requests / Quota windowCurrent requests against the included allowance, and the window they count in. Shown when the plan has a request quota.

JSON output

{"schema":"solwyn.overview.v1","total_spend":42.5,"total_requests":5100,"project_count":3,"trend_vs_last_period":0.125,"period_start":"2026-09-01","period_end":"2026-09-30","savings":{"saved_cost":4.25,"saved_cost_upper":null,"saved_input_tokens":12000,"blocked_call_count":6},"quota_exceeded":true,"included_requests":5000,"current_requests":5100,"window_start":"2026-09-01T00:00:00Z","window_end":"2026-10-01T00:00:00Z"}

trend_vs_last_period is a ratio in JSON and a percentage in the table. Optional fields that are null — savings, included_requests, current_requests, window_start, window_end — are omitted from the payload rather than emitted as null.

On this page