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>'import requests
url = "https://api.example.com/v1/wallet/internal/card_linked"
headers = {
"x-client-key": "<x-client-key>",
"Authorization": "<authorization>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-client-key': '<x-client-key>', Authorization: '<authorization>'}
};
fetch('https://api.example.com/v1/wallet/internal/card_linked', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/wallet/internal/card_linked",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"x-client-key: <x-client-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/wallet/internal/card_linked"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-client-key", "<x-client-key>")
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/wallet/internal/card_linked")
.header("x-client-key", "<x-client-key>")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/wallet/internal/card_linked")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-client-key"] = '<x-client-key>'
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body[
{
"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
}
]
Wallet
List Card-Linked Wallets
Retrieve all custodial wallets currently linked to the user’s card
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>'import requests
url = "https://api.example.com/v1/wallet/internal/card_linked"
headers = {
"x-client-key": "<x-client-key>",
"Authorization": "<authorization>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-client-key': '<x-client-key>', Authorization: '<authorization>'}
};
fetch('https://api.example.com/v1/wallet/internal/card_linked', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/v1/wallet/internal/card_linked",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"x-client-key: <x-client-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v1/wallet/internal/card_linked"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-client-key", "<x-client-key>")
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/v1/wallet/internal/card_linked")
.header("x-client-key", "<x-client-key>")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v1/wallet/internal/card_linked")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-client-key"] = '<x-client-key>'
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body[
{
"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
string
required
Your public API client key
string
required
Bearer token for authentication
Response
string
Linked wallet identifier
string
Wallet blockchain address
string
Currency code (e.g., “sol”, “usdc”)
string
Blockchain network (e.g., “solana”, “ethereum”)
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"
import requests
url = "https://dev.api.baanx.com/v1/wallet/internal/card_linked"
headers = {
"x-client-key": "YOUR_CLIENT_KEY",
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
response = requests.get(url, headers=headers)
linked_wallets = response.json()
print(f"Linked wallets: {len(linked_wallets)}")
for wallet in sorted(linked_wallets, key=lambda w: w['priority']):
print(f"{wallet['priority']}. {wallet['currency'].upper()} on {wallet['network']}")
interface LinkedWallet {
id: string;
address: string;
currency: string;
network: string;
priority: number;
}
async function getLinkedWallets(): Promise<LinkedWallet[]> {
const response = await fetch(
'https://dev.api.baanx.com/v1/wallet/internal/card_linked',
{
headers: {
'x-client-key': 'YOUR_CLIENT_KEY',
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
}
);
return await response.json();
}
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.
Related Endpoints
- Link Wallet to Card - Add a wallet as a card payment source
- Unlink Wallet from Card - Remove a wallet from card payment sources
- Update Linked Wallet Priority - Change charging order
- Get Internal Wallets - View all available wallets
Was this page helpful?