Subaccount Balance

Retrieving crypto or fiat subaccount balances.

Your business must have a custodial services agreement with Beta Ramps to use this service.

Retrieve the balance of an specific asset for a specific account or subaccount

GET https://live.betaapp.com/v1/balance

Query Parameters

Name	Type	Description
asset*	String	Check Crypto and Fiat capabilities for more information

Headers

Name	Type	Description
Authorization*	String	Bearer {access_token}
x-sub-account-id*	String	Subaccount ID.

200: OK Sucess

{
  "message": "string",
  "number_of_orders_associated": 0,
  "total_asset": "string",
  "total_amount": 0,
}

400: Bad Request Error message

{
  "message": "string"
}

Request Example:

curl -X 'GET' \
  'https://live.betaapp.com/v1/balance?asset=BRL' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g'

Response Example:

{
  "total_amount": 18500,
  "total_fees": 185,
  "number_of_orders_associated": 22
}

The total_fees parameter represents the amount in fees that will be discounted during the settlement process.