# Pricing and spending limits

Check the pricing unit, set a maximum charge and read the actual bill from the Run.

## Inspect the price before execution

A tool may charge per call or per result. Compare both the price and its unit, then bound the input volume. Do not assume that a single request containing multiple items costs the same as one item.

Discover and inspect do not consume tool credits. Tool execution can charge your account. Send the inspected priceRevision with the request; if a new task is explicitly rejected because its price changed, inspect again before preparing a replacement request. If submission is uncertain, preserve the original request and idempotency key until you recover its outcome.

## Set a cap for every Run

maxChargeMicros is required on every Run. Use an exact integer string in USD micro-units for balance funding. For example, 10000 represents $0.01; this is a unit-conversion example, not a tool quote.

Account spending controls can impose additional daily and per-Run limits. These controls still apply even if a request allows a higher charge. The daily window uses UTC.

- [Spending controls](/budget): Review your account's configured budget.

## Understand available and held funds

Read billing.chargedMicros and billing.refundedMicros from the original Run for its actual charge and refund. Use billing.heldMicros to check whether funds are still reserved. A tool can report a failure or cancellation after doing billable work; read billing.status and billing.chargedMicros for the final charge.

| Field | Meaning |
| --- | --- |
| balanceMicros | Account balance recorded by the ledger. |
| availableMicros | Amount currently available for new requests. |
| heldMicros | Funds reserved for calls whose settlement is not yet complete. |
| paidCallsAllowed | Whether the account currently permits paid calls. |

## Add funds from the console

Open Wallet to see the available top-up methods and quoted amount, including any processing fee. Review the amount and select Continue to checkout to open the payment page. You can resume a pending payment from Wallet history. After checkout, check the order and balance to confirm that funds arrived.

For Anyway top-ups, the subtotal before tax is (credit + $0.50) / (1 - 3.9%), rounded up to the next cent. The processing fee is the subtotal minus your credit: $10 of credit costs $10.93 before tax; $0.10 costs $0.63. Applicable taxes appear at checkout. Processing fees are not refundable when refunding unused credit. Existing orders keep their original quote.

The CLI uses account balance. Per-Run wallet payment requires a separate compatible wallet client and its exact network, asset, recipient and amount; it is not enabled by adding an API key.

- [Open Wallet](/wallet): Check your balance and available top-up options.