curl --request GET \
--url https://api.sand.etherfuse.com/organization/{organizationId}/balances \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.sand.etherfuse.com/organization/{organizationId}/balances', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/organization/{organizationId}/balances"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"wallets": [
{
"address": "3XnhVzKqNTz2wpNjyhbCsSFvz4Y6VNSVaVNhFTNGmqxr",
"balances": [
{
"amountInFiat": "1932.551274",
"amountInUsd": "105.214877",
"balance": "1500.123456",
"currency": "mxn",
"identifier": "CETES7CKqqKQizuSN6iWQwmTeFRjbJR6Vw2XRKfEDR8f",
"symbol": "cetes",
"tokenKind": "bond"
}
],
"chain": "solana",
"observedAt": "2026-10-07T12:00:00Z",
"paymentAccountId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"status": "current",
"updatedAt": "2026-10-07T12:20:00Z"
}
]
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}List organization balances
Returns the balances of every wallet the organization holds: every Etherfuse token and supported stablecoin each wallet holds, with the value of each in the asset’s own fiat currency and in USD. We list only the organization’s own wallets, not the wallets of its customer organizations.
We store each wallet’s balances and read the wallet from the chain at most once an hour. This call reads only the organization’s most recently used wallets: the ones in its latest orders, then the ones added most recently, up to a limit. When we last read one of those more than an hour ago, this call starts a new read and returns the wallet with status updating and the balances we stored before. Call again a few seconds later for the new balances. Other wallets we last read more than an hour ago come back with status stale; read one of them with Get payment account balances. An embedded wallet we have not created yet is left out.
Values use the current price and FX rate, so two calls seconds apart can differ for the same stored balance.
curl --request GET \
--url https://api.sand.etherfuse.com/organization/{organizationId}/balances \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.sand.etherfuse.com/organization/{organizationId}/balances', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/organization/{organizationId}/balances"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"wallets": [
{
"address": "3XnhVzKqNTz2wpNjyhbCsSFvz4Y6VNSVaVNhFTNGmqxr",
"balances": [
{
"amountInFiat": "1932.551274",
"amountInUsd": "105.214877",
"balance": "1500.123456",
"currency": "mxn",
"identifier": "CETES7CKqqKQizuSN6iWQwmTeFRjbJR6Vw2XRKfEDR8f",
"symbol": "cetes",
"tokenKind": "bond"
}
],
"chain": "solana",
"observedAt": "2026-10-07T12:00:00Z",
"paymentAccountId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"status": "current",
"updatedAt": "2026-10-07T12:20:00Z"
}
]
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}{
"detail": "quote 5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b has expired or does not exist",
"instance": "tag:etherfuse.com,2026-08-28:R2-10120/0b1c2d3e-4f50-4a6b-8c7d-9e0f1a2b3c4d",
"status": 400,
"title": "Quote expired",
"type": "https://docs.etherfuse.com/ramp/v2/errors/quote-expired",
"errors": [
{
"detail": "This field is required.",
"pointer": "#/accountDetails/clabe"
}
],
"missing": [
"<string>"
],
"required": [
"<string>"
],
"traceId": "4bf92f3577b34da6a3ce929d0e0e4736"
}