Consultar Saldo

Requer autenticação

GET/v2/account/balance

Retorna o saldo disponível, bloqueado e pendente de todas as moedas da conta. Inclui cotação em USD e BRL, percentual de alocação e totais consolidados.

Sem parâmetros. Apenas o token no header.

Rate limit

120 reqs/min.

Erros

Código	HTTP	Descrição
`INVALID_TOKEN`	401	Token inválido ou malformado
`TOKEN_EXPIRED`	401	Token expirou — gere um novo
`RATE_LIMIT_EXCEEDED`	429	Mais de 120 reqs/min — espere `Retry-After`

cURL

PHP

JavaScript

Python

curl -X GET https://api.bspay.co/v2/account/balance \
  -H "Authorization: Bearer SEU_TOKEN"

Resposta 200

{
  "success": true,
  "data": {
    "balances": [
      {
        "type": "fiat",
        "currency": "BRL",
        "available": "8446.75",
        "blocked": "7682.19",
        "pending": "0.00",
        "balance_hold": "0.00",
        "total": "16128.94",
        "price_usd": "0.19385044",
        "price_brl": "1.00000000",
        "total_usd": "3126.60198502",
        "total_brl": "16128.93902615",
        "allocation": "2.94"
      },
      {
        "type": "crypto",
        "currency": "USDT",
        "available": "101639.40402605",
        "blocked": "0.00000000",
        "pending": "0.00000000",
        "balance_hold": "0.00000000",
        "total": "101639.40402605",
        "price_usd": "1.00000000",
        "price_brl": "5.15861600",
        "total_usd": "101639.40402605",
        "total_brl": "524318.65585914",
        "allocation": "95.73"
      },
      {
        "type": "fiat",
        "currency": "MXN",
        "available": "13705.11",
        "blocked": "0.00",
        "pending": "0.00",
        "balance_hold": "0.00",
        "total": "13705.11",
        "price_usd": "0.05592440",
        "price_brl": "0.28849251",
        "total_usd": "766.45014428",
        "total_brl": "3953.82197765",
        "allocation": "0.72"
      }
    ],
    "wallet_total_usd": "106172.09817828",
    "wallet_total_brl": "547701.08443680"
  },
  "request_id": "1a65b43fce4aa7c60f22d59d",
  "timestamp": "2026-04-04T13:19:02Z"
}

AnteriorSplitPróximoTransf. Interna