Skip to main content
GET
/
v1
/
wallet
/
internal
/
card_linked
List Card-Linked Wallets
curl --request GET \
  --url https://api.example.com/v1/wallet/internal/card_linked \
  --header 'Authorization: <authorization>' \
  --header 'x-client-key: <x-client-key>'
[
  {
    "id": "1693a6da-5945-4461-ba1c-0b9891f78848",
    "address": "DfKNsYfrCEHb7ScJkuMTtPTeDiyjmBBm9NMHnbR7uFHz",
    "currency": "sol",
    "network": "solana",
    "priority": 1
  },
  {
    "id": "7c1839ee-918e-4787-b74f-deeb48ead58b",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb4",
    "currency": "usdc",
    "network": "ethereum",
    "priority": 2
  }
]

​
Overview

Link internal (custodial) wallets to your card to use them as funding sources for card transactions. Users can link up to 5 wallets, with priority determining the order in which they are charged during purchases. Use Cases:
  • Enable card payments from specific wallets
  • Manage which currencies fund card transactions
  • Control payment source priority
  • Temporarily disable wallet usage for cards
Retrieve all custodial wallets currently linked to the user’s card.

​
Authentication

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

​
Response

​
id
string
Linked wallet identifier
​
address
string
Wallet blockchain address
​
currency
string
Currency code (e.g., “sol”, “usdc”)
​
network
string
Blockchain network (e.g., “solana”, “ethereum”)
​
priority
number
Charging priority (lower numbers charged first)
[
  {
    "id": "1693a6da-5945-4461-ba1c-0b9891f78848",
    "address": "DfKNsYfrCEHb7ScJkuMTtPTeDiyjmBBm9NMHnbR7uFHz",
    "currency": "sol",
    "network": "solana",
    "priority": 1
  },
  {
    "id": "7c1839ee-918e-4787-b74f-deeb48ead58b",
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb4",
    "currency": "usdc",
    "network": "ethereum",
    "priority": 2
  }
]

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

​
Important Notes

Maximum Limit: Users can link up to 5 wallets to their card.
Priority Management: Use the Update Linked Wallets Priority endpoint to control which wallet is charged first.