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>"
}
]
}Authorizations
API key sent in the Authorization header.
Query Parameters
Names the wallet by its identifier. Send either this or the blockchain and publicKey pair, never both and never neither.
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 The wallet's public address, sent together with blockchain. Match the address exactly as you registered it, including its casing.
Response
The wallet's held balances
The wallet you named, echoed back. Present whichever form you sent, so a request that used blockchain and publicKey still returns the wallet's cryptoWalletId here.
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 The named wallet's public address
When the balances were read
One entry per held asset. Empty when the wallet holds none.
Show child attributes
Show child attributes