Wallet
Get balances
Fetch all token balances for the agent’s wallet
GET
/
wallets
/
me
/
balances
curl https://api.useknot.xyz/wallets/me/balances \
-H "Authorization: Bearer <token>"
{
"status": true,
"data": {
"solanaAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"sol": {
"balance": 1.5,
"usdValue": 129.00
},
"tokens": [
{
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"symbol": "USDC",
"balance": 250.00,
"decimals": 6,
"usdValue": 250.00
}
],
"totalUsdValue": 379.00
}
}
Returns the current SOL balance, all SPL token balances, and the total USD value of the agent’s wallet.
Requires authentication via Bearer token.
Response
boolean
true when the request succeeds.object
Show properties
Show properties
string
The agent’s Solana wallet address.
object
array
number
Combined USD value of SOL and all SPL token holdings.
Errors
| Status | Description |
|---|---|
401 | Missing or invalid Bearer token |
429 | Rate limit exceeded |
curl https://api.useknot.xyz/wallets/me/balances \
-H "Authorization: Bearer <token>"
{
"status": true,
"data": {
"solanaAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"sol": {
"balance": 1.5,
"usdValue": 129.00
},
"tokens": [
{
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"symbol": "USDC",
"balance": 250.00,
"decimals": 6,
"usdValue": 250.00
}
],
"totalUsdValue": 379.00
}
}
curl https://api.useknot.xyz/wallets/me/balances \
-H "Authorization: Bearer <token>"
{
"status": true,
"data": {
"solanaAddress": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
"sol": {
"balance": 1.5,
"usdValue": 129.00
},
"tokens": [
{
"mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"symbol": "USDC",
"balance": 250.00,
"decimals": 6,
"usdValue": 250.00
}
],
"totalUsdValue": 379.00
}
}