Docs / Admin
Commercial Levers
Five knobs that drive TokenOne®'s margin. Every change is audited (old value / new value / reason). Platform-admin only.
The five levers
token_usd_rate· top-up price charged to customers + internal upstream cost basis. Two-sided so you can model margin before flipping rates.pass_back_ratio· fraction of routing savings passed back to users as wallet credit (default 0.6). Bigger usage, bigger share passed back.benchmark_ceilings· per-capability-tier (heavy / balanced / cheap) rate used as the “would-have-cost” baseline for savings calc. Route-pick reads from here on every call.upstream_markup_pct· markup applied to raw Fireworks / OpenRouter cost before entering the margin calc (default 0.1 = 10%).model_tier_map· model_id → tier classification. Seeded with Opus / Sonnet / Haiku / GPT-4o family / Llama / DeepSeek; expandable via admin UI.
Changing a lever
- Open the
/commercial-leverspage in admin-console. - Click Edit on the lever row.
- Update the JSON value. Enter a reason (min 3 chars) · this is written to
AuditLogalongside the old + new values so margin movement is always explainable after the fact. - Click Save. The in-process route-pick cache is invalidated immediately · next proxy call uses the new value.
History
Every lever has a History drawer (GET /api/admin/commercial-levers/:name/history) showing who changed what, when, and why. Use this before any margin investigation to reconstruct the decision sequence.
Call log export
The /commercial-levers page also hosts the LLM call log export panel. Specify days (1-365) + row limit (1-100k) + tenant filter (UUID or "all"), download as CSV or JSON. BigInt token fields are serialised as strings; timestamps are ISO 8601.