Get Master Crypto Wallet
curl --request GET \
--url https://api.example.com/api/v1/wallets/crypto/master \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.example.com/api/v1/wallets/crypto/master"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.example.com/api/v1/wallets/crypto/master', 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/api/v1/wallets/crypto/master",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-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/api/v1/wallets/crypto/master"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
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/api/v1/wallets/crypto/master")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/wallets/crypto/master")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Master crypto wallet retrieved successfully",
"data": [
{
"address": "GbnnysYh3Y1ZLqPxkaz....76Upv12iP4sNGeHA2H4z2",
"network": "solana",
"tokens": {
"usdc": {
"amount": "0",
"rawAmount": "0"
},
"usdt": {
"amount": "0",
"rawAmount": "0"
}
}
}
]
}
{
"success": false,
"message": "Master wallet not found for merchant",
"statusCode": 400
}
Crypto Wallets
Get Master Crypto Wallet
Retrieve all of the merchant’s crypto addresses and their token balances
GET
/
api
/
v1
/
wallets
/
crypto
/
master
Get Master Crypto Wallet
curl --request GET \
--url https://api.example.com/api/v1/wallets/crypto/master \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.example.com/api/v1/wallets/crypto/master"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
fetch('https://api.example.com/api/v1/wallets/crypto/master', 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/api/v1/wallets/crypto/master",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <x-api-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/api/v1/wallets/crypto/master"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<x-api-key>")
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/api/v1/wallets/crypto/master")
.header("x-api-key", "<x-api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/wallets/crypto/master")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Master crypto wallet retrieved successfully",
"data": [
{
"address": "GbnnysYh3Y1ZLqPxkaz....76Upv12iP4sNGeHA2H4z2",
"network": "solana",
"tokens": {
"usdc": {
"amount": "0",
"rawAmount": "0"
},
"usdt": {
"amount": "0",
"rawAmount": "0"
}
}
}
]
}
{
"success": false,
"message": "Master wallet not found for merchant",
"statusCode": 400
}
The master crypto wallet returns every crypto address belonging to the merchant (resolved from the authenticated API key), each with its live token balances. No wallet ID is required.
Headers
string
required
API Key for authentication
Request Example
curl -X GET https://api-production.fossapay.com/api/v1/wallets/crypto/master \
-H "x-api-key: your_api_key_here"
const response = await fetch(
'https://api-production.fossapay.com/api/v1/wallets/crypto/master',
{
method: 'GET',
headers: {
'x-api-key': 'your_api_key_here',
'Content-Type': 'application/json'
}
}
);
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const data = await response.json();
const addresses = data.data;
import requests
url = "https://api-production.fossapay.com/api/v1/wallets/crypto/master"
headers = {"x-api-key": "your_api_key_here"}
response = requests.get(url, headers=headers)
data = response.json()
addresses = data["data"]
Response
boolean
Response status
string
Human-readable response message
array
Response Example
{
"success": true,
"message": "Master crypto wallet retrieved successfully",
"data": [
{
"address": "GbnnysYh3Y1ZLqPxkaz....76Upv12iP4sNGeHA2H4z2",
"network": "solana",
"tokens": {
"usdc": {
"amount": "0",
"rawAmount": "0"
},
"usdt": {
"amount": "0",
"rawAmount": "0"
}
}
}
]
}
{
"success": false,
"message": "Master wallet not found for merchant",
"statusCode": 400
}
Error Codes
| Code | Description |
|---|---|
400 | No crypto addresses found for merchant |
401 | Invalid or missing API key |
⌘I

