---
title: "Get balance"
method: GET
path: "/api/v1/balance"
tags: ["Account"]
---

# Get balance

`GET /api/v1/balance`

## Request

- Base URL: `https://spoofy.social`
- URL: `https://spoofy.social/api/v1/balance`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Your spendable balance in USD.

## Response `200`

Balance.

- Balance
  - `balance` string: Spendable balance. USD as a decimal string.
  - `currency` 'USD'

## Other responses

- `401`: No valid API key or session.
- `429`: Slow down: too many requests in a short time. Wait `Retry-After` seconds and carry on.

---

[API](https://skmtc.dev/spoofy/apis/spoofy-api.md) · [All operations](https://skmtc.dev/spoofy/apis/spoofy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoofy/apis/spoofy-api/revisions/58adc986f826?raw)