---
title: "Account balance"
method: GET
path: "/v2/balance/"
tags: ["Account"]
---

# Account balance

`GET /v2/balance/`

## Request

- Base URL: `https://magicmarkets.com` (the document declares no server; this is the origin it was published from)
- URL: `https://magicmarkets.com/v2/balance/`
- Auth: API key in header `X-Api-Key`

Returns the authenticated user's current balance, total stake on open bets, and smart credit. All values are `["USDT", amount]` tuples. The same three figures are pushed on the stream as the `balance` message; `open_stake` is positive.

## Response `200`

Account balance

- BalanceEnvelope
  - `status` 'ok'
  - `data` BalanceResponse
    - `balance` union[], required: [currency, amount] - e.g. ["USDT", 115.38]
      - union
        - string
        - number
    - `open_stake` union[], required: [currency, amount] - e.g. ["USDT", 115.38]
      - union
        - string
        - number
    - `smart_credit` union[], required: [currency, amount] - e.g. ["USDT", 115.38]
      - union
        - string
        - number

## Other responses

- `401`: Authentication failed - API key missing, malformed, or rejected.
- `403`: Authorization failed - the key is valid but cannot perform this action.
- `429`: Rate limit hit. Honour the `Retry-After` header.
- `500`: Unexpected internal error. Quote `data[1]` (the token) when contacting support.

---

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