---
title: "Get the maximum spendable Bitcoin amount for the given address (v2)."
method: GET
path: "/v2/get-max-spendable/{address}"
tags: ["v2"]
---

# Get the maximum spendable Bitcoin amount for the given address (v2).

`GET /v2/get-max-spendable/{address}`

## Path parameters

- `address` string, required

## Response `200`

Get the maximum spendable Bitcoin amount for the given address after accounting for estimated transaction fees

- GatewayMaxSpendable
  - `amount` GatewayTokenAmount, required
    - `address` string, required
    - `amount` string, required
    - `chain` string, required
  - `userAddress` string, required

## Other responses

- `400` — Get max spendable error

## Changes

- **2026-05-26** `ca0ef15d5879` — 3 breaking, 26 info
  - added `#/components/schemas/GatewayErrorCode, #/components/schemas/GatewayErrorCodeV2Variants` to the `code` response property `oneOf` list for the response status `400`
  - added `#/components/schemas/GatewayErrorDetailsV2` to the `details` response property `oneOf` list for the response status `400`
  - the `code` response's property type changed from `string` to no type for status `400`
  - api operation id `get_max_spendable` removed and replaced with `get_max_spendable_v2`
  - …25 more
- **2026-05-06** `162bab886181` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bob-collective/apis/bob-gateway-api/changes/v2/get-max-spendable/:address/get.md)

---

[API](https://skmtc.dev/bob-collective/apis/bob-gateway-api.md) · [All operations](https://skmtc.dev/bob-collective/apis/bob-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bob-collective/bob-gateway-api/revisions/5a00610487e4/schema)