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.