Read your USDT balance
curl --request GET \
--url https://examples.staging.rampapay.com/v1/wallets \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://examples.staging.rampapay.com/v1/wallets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://examples.staging.rampapay.com/v1/wallets"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"currency": "USDT",
"available": "897.960000",
"reserved": "0.000000",
"as_of": "2026-09-27T14:06:40.000Z",
"top_up_addresses": [
{
"chain": "tron",
"address": "TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb"
}
]
}Wallet
Read your USDT balance
Scope: wallet:read
available is what you can spend now. reserved is held by payments that have not finished yet. top_up_addresses are your wallet addresses — today one, on Tron. It is created the first time you read your wallet, so there is nothing to create; if the list is ever empty, read it again a moment later. Send only USDT on the stated chain. Once a USDT transfer to your top-up address confirms on-chain, we credit it automatically, once per transfer — no call needed. Each transfer shows up in your transactions as an in row: pending while it confirms, then completed, with a deposit.* webhook at each step.
GET
/
wallets
Read your USDT balance
curl --request GET \
--url https://examples.staging.rampapay.com/v1/wallets \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://examples.staging.rampapay.com/v1/wallets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://examples.staging.rampapay.com/v1/wallets"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"currency": "USDT",
"available": "897.960000",
"reserved": "0.000000",
"as_of": "2026-09-27T14:06:40.000Z",
"top_up_addresses": [
{
"chain": "tron",
"address": "TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb"
}
]
}