Skip to main content
GET
/
v1
/
wallet
/
external
/
priority
Get External Wallet Priority
curl --request GET \
  --url https://api.example.com/v1/wallet/external/priority \
  --header 'Authorization: <authorization>' \
  --header 'x-client-key: <x-client-key>'
[
  {
    "id": 551,
    "address": "0x3a11a86cf218c448be519728cd3ac5c741fb3424",
    "currency": "usdc",
    "network": "linea",
    "priority": 1
  },
  {
    "id": 552,
    "address": "0x7b22c1e6f8a4d92b5c3d8e9f1a2b3c4d5e6f7890",
    "currency": "usdt",
    "network": "ethereum",
    "priority": 2
  },
  {
    "id": 553,
    "address": "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK",
    "currency": "usdc",
    "network": "solana",
    "priority": 3
  }
]

​
Overview

Manage the priority order of registered external wallets. Priority determines the order in which wallets are evaluated for funding transactions. When a transaction is initiated, the platform checks wallets in priority order (1, 2, 3…). The first wallet with sufficient balance and allowance to cover the entire transaction cost is used. Only one wallet funds each transaction — multi-funding is not supported. Lower priority numbers are checked first (priority 1 before priority 2). Use Cases:
  • Control wallet selection order for transactions
  • Optimize for network fees across chains
  • Ensure transactions succeed with fallback wallets
  • Route withdrawals to specific wallets
Get the current priority order of all registered external wallets.

​
Authentication

​
x-client-key
string
required
Your public API client key
​
Authorization
string
required
Bearer token for authentication

​
Response

​
id
number
Wallet priority identifier
​
address
string
Blockchain wallet address
​
currency
string
Currency code (e.g., “usdc”, “usdt”)
​
network
string
Blockchain network (e.g., “linea”, “ethereum”, “solana”)
​
priority
number
Current priority value (lower = higher priority)
[
  {
    "id": 551,
    "address": "0x3a11a86cf218c448be519728cd3ac5c741fb3424",
    "currency": "usdc",
    "network": "linea",
    "priority": 1
  },
  {
    "id": 552,
    "address": "0x7b22c1e6f8a4d92b5c3d8e9f1a2b3c4d5e6f7890",
    "currency": "usdt",
    "network": "ethereum",
    "priority": 2
  },
  {
    "id": 553,
    "address": "DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK",
    "currency": "usdc",
    "network": "solana",
    "priority": 3
  }
]

curl -X GET "https://dev.api.baanx.com/v1/wallet/external/priority" \
  -H "x-client-key: YOUR_CLIENT_KEY" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"