Get Available Balances
Get Available Balances
Returns the available balances in the supported currencies for your account.
Under the terms of the Gemini API Agreement, polling this endpoint may be subject to rate limiting.
Gemini is currently in the process of introducing new API architecture that will impact how decimal balances are returned from this endpoint for fiat and crypto assets.
As a result of this change, requests routed via the new architecture will return fiat balances and crypto balances truncated to 15 and 19 decimal places, respectively. It is recommended that users floor the values returned from this endpoint to the correct precision until the migration has been completed.
curl --request POST \
--url https://api.gemini.com/v1/balances \
--header 'Content-Type: application/json' \
--header 'X-GEMINI-APIKEY: <string>' \
--header 'X-GEMINI-PAYLOAD: <string>' \
--header 'X-GEMINI-SIGNATURE: <string>' \
--data '
{
"request": "/v1/balances",
"nonce": "<nonce>",
"account": "primary",
"showPendingBalances": true
}
'Roles
The API key you use to access this endpoint must have the Trader, Fund Manager, or Auditor role assigned. See Roles for more information.
The OAuth scope must have balances:read assigned to access this endpoint. See OAuth Scopes for more information.
Headers
Request Body
Responses
The account balances