---
title: "Get your balance"
method: GET
path: "/tools/balance"
tags: ["Tools"]
---

# Get your balance

`GET /tools/balance`

## Request

- Base URL: `https://api.orcarouter.ai/v1`
- URL: `https://api.orcarouter.ai/v1/tools/balance`
- Auth: HTTP bearer

What you can spend on tools right now. Size a batch from
`spendable_usd`, not `wallet_usd`.

## Headers

- `X-Orca-Run-Ref` string

## Response `200`

OK

- object
  - `success` boolean
  - `data` ToolsBalance
    - `wallet_usd` number: The workspace wallet. Can be 0 or negative with a credit line.
    - `spendable_usd` number: What a run may take now — the lower of wallet plus credit and the key's remaining quota; 0 when the key cannot spend or the member is over a hard-stop monthly budget.
    - `agent_month_left_usd` number
    - `run_left_usd` number

## Other responses

- `503`: A Tools error. Branch on `code`. Refusals from the authentication layer have no `success` or `code`; see [Errors](/agent-infra/tools/errors).

## Changes

- **2026-11-03** `80ba8288c51d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orcarouter/apis/orcarouter-api/changes/tools/balance/get.md)

---

[API](https://skmtc.dev/orcarouter/apis/orcarouter-api.md) - [All operations](https://skmtc.dev/orcarouter/apis/orcarouter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orcarouter/apis/orcarouter-api/revisions/80ba8288c51d?raw)