curl --request GET \
--url https://api.sand.etherfuse.com/ramp/balances \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.sand.etherfuse.com/ramp/balances', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/balances"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"blockchain": "stellar",
"publicKey": "<string>",
"observedAt": "2023-11-07T05:31:56Z",
"balances": [
{
"symbol": "<string>",
"identifier": "<string>",
"balance": "<string>",
"currency": "<string>",
"amountInFiat": "<string>",
"amountInUsd": "<string>"
}
]
}Get one wallet's balances
Reads one wallet, the one you name on the call. It never picks a wallet for you, so an organization with many registered wallets calls this once per wallet.
Name the wallet with cryptoWalletId, or with blockchain and publicKey together.
Send exactly one of those two forms. The response echoes the wallet back as walletId,
blockchain, and publicKey, so both forms return the same object for the same wallet.
The wallet must be registered to your organization or to one of its child organizations.
For that wallet you get the current balance of every supported Etherfuse asset it holds, with the value of each in the asset’s own fiat currency and in USD.
Assets are resolved from the Etherfuse catalog for the wallet’s chain, so no asset list
is accepted or required. Assets with a zero balance are omitted, so an empty
balances array is a successful read of a wallet holding nothing.
currency is per balance, because one wallet can hold CETES denominated in MXN and
TESOURO denominated in BRL at the same time. balance carries the asset’s own decimal
precision; the two value fields carry six decimal places. Interest-bearing assets accrue
continuously, so two calls seconds apart can return different values for an unchanged
balance.
curl --request GET \
--url https://api.sand.etherfuse.com/ramp/balances \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.sand.etherfuse.com/ramp/balances', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.sand.etherfuse.com/ramp/balances"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"blockchain": "stellar",
"publicKey": "<string>",
"observedAt": "2023-11-07T05:31:56Z",
"balances": [
{
"symbol": "<string>",
"identifier": "<string>",
"balance": "<string>",
"currency": "<string>",
"amountInFiat": "<string>",
"amountInUsd": "<string>"
}
]
}Query Parameters
Names the wallet by chain and address, together with publicKey. Send this pair instead of cryptoWalletId, not alongside it.
Canonical blockchain enum for API serialization.
Use this type for JSON APIs and WebSocket messages.
For database storage, convert to BlockchainType.
stellar, solana, base, polygon, monad, avalanche Response
The wallet's held balances