Get account balance
curl --request GET \
--url https://api.privy.io/v1/accounts/{account_id}/balance \
--header 'Authorization: Basic <encoded-value>' \
--header 'privy-app-id: <privy-app-id>'HttpResponse<String> response = Unirest.get("https://api.privy.io/v1/accounts/{account_id}/balance")
.header("privy-app-id", "<privy-app-id>")
.header("Authorization", "Basic <encoded-value>")
.asString();const options = {
method: 'GET',
headers: {'privy-app-id': '<privy-app-id>', Authorization: 'Basic <encoded-value>'}
};
fetch('https://api.privy.io/v1/accounts/{account_id}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.privy.io/v1/accounts/{account_id}/balance",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"privy-app-id: <privy-app-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.privy.io/v1/accounts/{account_id}/balance"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("privy-app-id", "<privy-app-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"total": {
"value": "100.00",
"currency": "usd"
},
"assets": [
{
"symbol": "<string>",
"amount": "<string>",
"price": {
"value": "100.00",
"currency": "usd"
}
}
],
"assets_by_chain": [
{
"symbol": "<string>",
"amount": "<string>",
"price": {
"value": "100.00",
"currency": "usd"
},
"chain_id": "<string>"
}
]
}Accounts
Get account balance
Get the balance of an account, aggregated across all wallets and supported chains.
GET
/
v1
/
accounts
/
{account_id}
/
balance
Get account balance
curl --request GET \
--url https://api.privy.io/v1/accounts/{account_id}/balance \
--header 'Authorization: Basic <encoded-value>' \
--header 'privy-app-id: <privy-app-id>'HttpResponse<String> response = Unirest.get("https://api.privy.io/v1/accounts/{account_id}/balance")
.header("privy-app-id", "<privy-app-id>")
.header("Authorization", "Basic <encoded-value>")
.asString();const options = {
method: 'GET',
headers: {'privy-app-id': '<privy-app-id>', Authorization: 'Basic <encoded-value>'}
};
fetch('https://api.privy.io/v1/accounts/{account_id}/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.privy.io/v1/accounts/{account_id}/balance",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"privy-app-id: <privy-app-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.privy.io/v1/accounts/{account_id}/balance"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("privy-app-id", "<privy-app-id>")
req.Header.Add("Authorization", "Basic <encoded-value>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"total": {
"value": "100.00",
"currency": "usd"
},
"assets": [
{
"symbol": "<string>",
"amount": "<string>",
"price": {
"value": "100.00",
"currency": "usd"
}
}
],
"assets_by_chain": [
{
"symbol": "<string>",
"amount": "<string>",
"price": {
"value": "100.00",
"currency": "usd"
},
"chain_id": "<string>"
}
]
}Authorizations
Basic Auth header with your app ID as the username and your app secret as the password.
Headers
ID of your Privy app.
Path Parameters
ID of the account.
Minimum string length:
1Query Parameters
When set to true, returns balances from testnet chains instead of mainnets.
Available options:
true, false Response
200 - application/json
The account balance.
The balance of a digital asset account, aggregated across all wallets and supported chains.
The total balance across all assets.
Show child attributes
Show child attributes
Example:
{ "value": "100.00", "currency": "usd" }
The individual asset balances, each computed across all supported chains.
Show child attributes
Show child attributes
Individual asset balances per chain.
Show child attributes
Show child attributes
Was this page helpful?

