Feature Request: Add Zen balance API endpoint

[uwagz]

Summary

Add a public API endpoint to query the current Zen account balance programmatically.

Use Case

I'd like to display my Zen balance in my system status bar (waybar on Linux). Currently, the only way to check balance is through the web dashboard, which makes automation impossible.

A simple endpoint like GET /zen/v1/balance (authenticated with the existing API key) would enable:

• Status bar widgets showing remaining credits
• Alerts when balance drops below a threshold
• Integration with budgeting/monitoring tools
• CI pipelines that check balance before expensive runs

Proposed API

GET https://opencode.ai/zen/v1/balance
Authorization: Bearer <api-key>

Response:
{
  "balance": 42.50,
  "currency": "USD",
  "auto_reload": {
    "enabled": true,
    "threshold": 5.00,
    "amount": 20.00
  }
}

Workaround

Currently using opencode stats to track local spending, but this doesn't reflect the actual account balance.

Additional Context

The auto-reload feature suggests the infrastructure to query balance already exists server-side. Exposing it via API would be a small addition with high utility for power users.

Thanks for building such a great tool! 🙏

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• Feature Request: Add Zen balance API endpoint #10447: Feature Request: Add Zen balance API endpoint

Feel free to ignore if this doesn't address your specific case.

[emmaneugene]

+1, I'm also trying to build a centralized monitoring tool for model usage across different subscription/API providers, and this would be very helpful

[aaesalamanca]

Same need here. I'm trying to build a macOS menu bar app to display the current balance so I don't have to navigate to the web dashboard.

[mderazon]

Also could unlock usage monitoring for OpenChamber: openchamber/openchamber#1357