List Wallets
curl --request GET \
--url https://secureapi.tender.cash/v1/api/wallet \
--header 'authorization: <api-key>' \
--header 'x-access-id: <x-access-id>' \
--header 'x-request-id: <x-request-id>' \
--header 'x-timestamp: <x-timestamp>'const options = {
method: 'GET',
headers: {
authorization: '<api-key>',
'x-timestamp': '<x-timestamp>',
'x-request-id': '<x-request-id>',
'x-access-id': '<x-access-id>'
}
};
fetch('https://secureapi.tender.cash/v1/api/wallet', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://secureapi.tender.cash/v1/api/wallet"
headers = {
"authorization": "<api-key>",
"x-timestamp": "<x-timestamp>",
"x-request-id": "<x-request-id>",
"x-access-id": "<x-access-id>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://secureapi.tender.cash/v1/api/wallet",
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: <api-key>",
"x-access-id: <x-access-id>",
"x-request-id: <x-request-id>",
"x-timestamp: <x-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": "success",
"message": "success",
"data": [
{
"wallet_reference": "user-8821",
"addresses": [
{
"network": "ethereum",
"address": "0xabc123...",
"address_reference": "ref-1"
}
]
}
],
"total": 42,
"pages": 3,
"page": 1,
"limit": 20
}Subwallets
List Wallets
Retrieve all subwallets created under your merchant account
GET
/
v1
/
api
/
wallet
List Wallets
curl --request GET \
--url https://secureapi.tender.cash/v1/api/wallet \
--header 'authorization: <api-key>' \
--header 'x-access-id: <x-access-id>' \
--header 'x-request-id: <x-request-id>' \
--header 'x-timestamp: <x-timestamp>'const options = {
method: 'GET',
headers: {
authorization: '<api-key>',
'x-timestamp': '<x-timestamp>',
'x-request-id': '<x-request-id>',
'x-access-id': '<x-access-id>'
}
};
fetch('https://secureapi.tender.cash/v1/api/wallet', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://secureapi.tender.cash/v1/api/wallet"
headers = {
"authorization": "<api-key>",
"x-timestamp": "<x-timestamp>",
"x-request-id": "<x-request-id>",
"x-access-id": "<x-access-id>"
}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://secureapi.tender.cash/v1/api/wallet",
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: <api-key>",
"x-access-id: <x-access-id>",
"x-request-id: <x-request-id>",
"x-timestamp: <x-timestamp>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": "success",
"message": "success",
"data": [
{
"wallet_reference": "user-8821",
"addresses": [
{
"network": "ethereum",
"address": "0xabc123...",
"address_reference": "ref-1"
}
]
}
],
"total": 42,
"pages": 3,
"page": 1,
"limit": 20
}Auth method: Signed (HMAC) — this endpoint requires the full set of signed
headers:
x-access-id, x-request-id, x-timestamp, and an HMAC-SHA256
authorization signature. See Authentication.Example
const res = await fetch(`${BASE}/wallet?page=1&limit=20`, {
headers: makeHeaders(),
});
const { data, total, pages, page, limit } = await res.json();
/*
data: [
{
wallet_reference: 'user-8821',
addresses: [
{ network: 'ethereum', address: '0xabc...', address_reference: 'ref-1' }
]
}
],
total: 42, pages: 3, page: 1, limit: 20
*/
res = requests.get(
f"{BASE}/wallet",
headers=make_headers(),
params={"page": 1, "limit": 20},
)
body = res.json()
wallets = body["data"]
total = body["total"]
Headers
string
required
Base64-encoded HMAC-SHA256 signature of the request payload using the API secretExample:
"5e73d044c44d733fcf819ad3409aaad..."string
required
Current timestamp in ISO 8601 formatExample:
"2025-03-15T09:45:53.000Z"string
required
Unique identifier for the request (UUID v4)Example:
"550e8400-e29b-41d4-a716-446655440000"string
required
Your API access ID provided by TenderExample:
"your-access-id-here"Query Parameters
number
Page number for pagination. Defaults to
1.Example: 1number
Number of wallets per page. Defaults to
20.Example: 20Response
string
required
Example:
"success"string
required
Example:
"success"array
required
number
Total number of wallets across all pages.Example:
42number
Total number of pages.Example:
3number
Current page number.Example:
1number
Number of results per page.Example:
20Authorizations
Signed (HMAC) authentication. Required headers: x-access-id, x-request-id (UUID v4), x-timestamp (ISO 8601), and authorization (Base64 HMAC-SHA256 signature of {timeStamp, requestId, accessId} using your access secret).
Headers
Response
200 - application/json
List of wallets