Get Fund Balance
curl --request GET \
--url https://pay-api.holdstation.com/partners/funds/balance \
--header 'Partner-App-Key: <partner-app-key>' \
--header 'X-HSPay-Signature: <x-hspay-signature>' \
--header 'X-HSPay-Timestamp: <x-hspay-timestamp>'import requests
url = "https://pay-api.holdstation.com/partners/funds/balance"
headers = {
"Partner-App-Key": "<partner-app-key>",
"X-HSPay-Signature": "<x-hspay-signature>",
"X-HSPay-Timestamp": "<x-hspay-timestamp>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'Partner-App-Key': '<partner-app-key>',
'X-HSPay-Signature': '<x-hspay-signature>',
'X-HSPay-Timestamp': '<x-hspay-timestamp>'
}
};
fetch('https://pay-api.holdstation.com/partners/funds/balance', 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://pay-api.holdstation.com/partners/funds/balance",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Partner-App-Key: <partner-app-key>",
"X-HSPay-Signature: <x-hspay-signature>",
"X-HSPay-Timestamp: <x-hspay-timestamp>"
],
]);
$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://pay-api.holdstation.com/partners/funds/balance"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Partner-App-Key", "<partner-app-key>")
req.Header.Add("X-HSPay-Signature", "<x-hspay-signature>")
req.Header.Add("X-HSPay-Timestamp", "<x-hspay-timestamp>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://pay-api.holdstation.com/partners/funds/balance")
.header("Partner-App-Key", "<partner-app-key>")
.header("X-HSPay-Signature", "<x-hspay-signature>")
.header("X-HSPay-Timestamp", "<x-hspay-timestamp>")
.asString();require 'uri'
require 'net/http'
url = URI("https://pay-api.holdstation.com/partners/funds/balance")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Partner-App-Key"] = '<partner-app-key>'
request["X-HSPay-Signature"] = '<x-hspay-signature>'
request["X-HSPay-Timestamp"] = '<x-hspay-timestamp>'
response = http.request(request)
puts response.read_body{
"message": "success",
"data": {
"success": true,
"code": 0,
"error": "",
"fund": {
"id": 1,
"partner_id": "partner-xyz",
"token": "USDT",
"balance": "1000.50",
"updated_at": { "seconds": 1700000000, "nanos": 0 }
}
}
}
{
"error": "invalid request",
"error_code": "BAD_REQUEST",
"message": "token is required"
}
Prefunding
Get Fund Balance
Get the balance of a specific partner fund by token symbol.
GET
/
partners
/
funds
/
balance
Get Fund Balance
curl --request GET \
--url https://pay-api.holdstation.com/partners/funds/balance \
--header 'Partner-App-Key: <partner-app-key>' \
--header 'X-HSPay-Signature: <x-hspay-signature>' \
--header 'X-HSPay-Timestamp: <x-hspay-timestamp>'import requests
url = "https://pay-api.holdstation.com/partners/funds/balance"
headers = {
"Partner-App-Key": "<partner-app-key>",
"X-HSPay-Signature": "<x-hspay-signature>",
"X-HSPay-Timestamp": "<x-hspay-timestamp>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'Partner-App-Key': '<partner-app-key>',
'X-HSPay-Signature': '<x-hspay-signature>',
'X-HSPay-Timestamp': '<x-hspay-timestamp>'
}
};
fetch('https://pay-api.holdstation.com/partners/funds/balance', 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://pay-api.holdstation.com/partners/funds/balance",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Partner-App-Key: <partner-app-key>",
"X-HSPay-Signature: <x-hspay-signature>",
"X-HSPay-Timestamp: <x-hspay-timestamp>"
],
]);
$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://pay-api.holdstation.com/partners/funds/balance"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Partner-App-Key", "<partner-app-key>")
req.Header.Add("X-HSPay-Signature", "<x-hspay-signature>")
req.Header.Add("X-HSPay-Timestamp", "<x-hspay-timestamp>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://pay-api.holdstation.com/partners/funds/balance")
.header("Partner-App-Key", "<partner-app-key>")
.header("X-HSPay-Signature", "<x-hspay-signature>")
.header("X-HSPay-Timestamp", "<x-hspay-timestamp>")
.asString();require 'uri'
require 'net/http'
url = URI("https://pay-api.holdstation.com/partners/funds/balance")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Partner-App-Key"] = '<partner-app-key>'
request["X-HSPay-Signature"] = '<x-hspay-signature>'
request["X-HSPay-Timestamp"] = '<x-hspay-timestamp>'
response = http.request(request)
puts response.read_body{
"message": "success",
"data": {
"success": true,
"code": 0,
"error": "",
"fund": {
"id": 1,
"partner_id": "partner-xyz",
"token": "USDT",
"balance": "1000.50",
"updated_at": { "seconds": 1700000000, "nanos": 0 }
}
}
}
{
"error": "invalid request",
"error_code": "BAD_REQUEST",
"message": "token is required"
}
Partners can query the balance of a specific fund by token symbol.
Authentication
string
required
Your partner app key.
string
required
Base64-encoded Ed25519 signature of the sign data.
string
required
Unix timestamp (seconds) of the request. Must be within 60 seconds of server time.
Query Parameters
string
required
Token symbol (e.g.,
USDT, USDC).{
"message": "success",
"data": {
"success": true,
"code": 0,
"error": "",
"fund": {
"id": 1,
"partner_id": "partner-xyz",
"token": "USDT",
"balance": "1000.50",
"updated_at": { "seconds": 1700000000, "nanos": 0 }
}
}
}
{
"error": "invalid request",
"error_code": "BAD_REQUEST",
"message": "token is required"
}