Wallets

Horizon uses a credit-based billing system called Wallets. Your wallet balance is consumed as agents execute tasks, call LLM APIs, and use third-party integrations. Think of it as a prepaid account that funds all AI activity across your organization.

How Credits Work

Credits are the universal billing unit in Horizon. Every billable action consumes credits based on its cost:

Action	Approximate Credit Cost
LLM prompt (per 1K input tokens)	1 credit
LLM completion (per 1K output tokens)	3 credits
Skill execution (per run)	1-10 credits depending on skill
Connection API call (per call)	0.5 credits
File processing (per MB)	2 credits

Exact credit costs vary by the LLM model selected for an agent. More capable models consume more credits per token. You can view the current credit pricing table on the Billing > Wallets page.

Note

Credits are not tied to a specific currency. You purchase credits with your payment method at the rate defined by your subscription plan. Higher-tier plans offer better credit-per-dollar rates.

Viewing Your Wallet

Navigate to Billing > Wallets to see your wallet dashboard:

• Current Balance — your available credit balance.
• Credits Used Today — a running total of credits consumed since midnight (organization timezone).
• Credits Used This Month — the monthly total so far.
• Projected Monthly Usage — an estimate based on your recent usage patterns.

Usage Breakdown

The usage breakdown chart shows credit consumption over time with the following views:

• By day — daily credit usage for the last 30 days.
• By department — how credits are distributed across departments.
• By agent — which agents are consuming the most credits.
• By action type — split between LLM calls, skill executions, and connection API calls.

Click any data point to drill into the specific transactions.

Adding Funds

1. Navigate to Billing > Wallets.
2. Click Add Funds.
3. Enter the credit amount you want to purchase (minimum 1,000 credits).
4. Review the total cost in your billing currency.
5. Select your payment method (credit card on file or add a new one).
6. Click Confirm Purchase.

Credits are available in your wallet immediately after the payment is processed. A receipt is sent to the billing email address.

Credit Packages

Horizon offers pre-defined credit packages at discounted rates:

Package	Credits	Discount
Starter	10,000	—
Growth	50,000	5%
Scale	200,000	10%
Enterprise	1,000,000	15%

You can also enter a custom amount. Custom purchases do not receive volume discounts unless negotiated in an enterprise agreement.

Auto-Reload

Auto-reload ensures your wallet never runs dry by automatically purchasing credits when your balance drops below a threshold.

1. Navigate to Billing > Wallets.
2. Click Configure Auto-Reload.
3. Set the threshold — the balance at which a reload is triggered (e.g., 5,000 credits).
4. Set the reload amount — the number of credits to purchase when triggered (e.g., 50,000 credits).
5. Set a monthly cap — the maximum amount that auto-reload can spend per billing cycle (prevents runaway costs).
6. Click Enable Auto-Reload.

Caution

Always set a monthly cap on auto-reload. Without a cap, unexpected spikes in agent activity could result in large, unexpected charges. Start conservative and increase the cap as you understand your usage patterns.

When an auto-reload occurs, a notification is sent to all users with the Admin role and the billing contact email. The transaction appears in your transaction history with the label “Auto-Reload.”

Budget Alerts

Configure alerts to be notified when credit usage reaches certain thresholds:

• Percentage-based — get alerted when you have used 50%, 75%, or 90% of a defined budget.
• Absolute balance — get alerted when your wallet balance drops below a specific amount.

Set up alerts on the wallet page under Budget Alerts. Alerts are delivered through your configured notification channels.

Transaction History

The transaction history table shows every credit movement in your wallet:

Column	Description
Date	When the transaction occurred.
Type	Purchase, Usage, Refund, or Adjustment.
Description	A human-readable description (e.g., “Agent ‘Invoice Bot’ — GPT-4 completion, 2,340 tokens”).
Agent	The agent that triggered the usage (if applicable).
Department	The department the activity belongs to.
Credits	The number of credits added (positive) or consumed (negative).
Balance	The wallet balance after this transaction.

You can filter transactions by date range, type, agent, or department. Click Export to download the transaction history as a CSV file for your records or accounting system.

Department Budgets

Organization Admins can allocate credit budgets to individual departments. When a department has a budget:

• Usage is tracked against the department’s allocation.
• Agents in the department stop executing when the department budget is exhausted (unless the Admin configures overflow behavior).
• Department managers can view their budget utilization on the department dashboard.

To set a department budget:

1. Navigate to Billing > Wallets.
2. Click Department Budgets.
3. Select a department and enter the monthly credit allocation.
4. Choose the overflow behavior: Stop (agents halt), Warn (agents continue but a notification is sent), or Unlimited (no cap, charges against the main wallet).
5. Click Save.

Tip

Department budgets are a powerful way to control costs in organizations with multiple teams using Horizon. They provide accountability without requiring separate billing for each team.

What Happens When Your Balance Reaches Zero

If your wallet balance reaches zero and auto-reload is not configured (or the monthly cap has been reached):

1. All running agents are paused — they stop executing tasks but retain their state.
2. Scheduled tasks are queued — they will execute once funds are available.
3. API calls return a 402 Payment Required response.
4. Notifications are sent to all Admins and the billing contact.

Add funds or adjust your auto-reload settings to resume operations. Agents automatically resume from their paused state once credits are available.