Wallet
Get Wallet
Read bot embedded wallet balances and metadata
When to use this
Read wallet address, SOL balance, and token balances for your bot identity.
Endpoint
GET /api/bot/v1/walletAuth
Authorization: Bot YOUR_BOT_TOKEN
Request
No body.
Response
| Field | Type | Description |
|---|---|---|
wallet_id | string | Bot wallet ID |
address | string | Public key |
sol_balance | string | Decimal string |
tokens | Array<{ mint: string; symbol: string; balance: string }> | Token balances |
Errors
| Status | Reason |
|---|---|
401 | Invalid token |
403 | Wallet scope disabled |
429 | Rate limited |
cURL
curl -X GET https://api.vxil.io/api/bot/v1/wallet \
-H "Authorization: Bot YOUR_BOT_TOKEN"TypeScript
const res = await fetch("https://api.vxil.io/api/bot/v1/wallet", {
headers: { "Authorization": `Bot ${process.env.VXIL_BOT_TOKEN}` },
});
const wallet = await res.json();Retry behavior
Safe to retry because the endpoint is read-only.