curl --request GET \
--url "https://api.stablepay.co/api/v1/account" \
--header "Authorization: Bearer <API_KEY>" \
--header "X-StablePay-Timestamp: <TIMESTAMP>" \
--header "X-StablePay-Nonce: <NONCE>" \
--header "X-StablePay-Signature: <SIGNATURE>"
const response = await fetch("https://api.stablepay.co/api/v1/account", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"object": "list",
"data": [
{
"account_no": "00000001",
"account_name": "Default Account",
"currency": "USDT",
"status": "active",
"is_system_default": true,
"editable": false,
"available_amount": 10000,
"frozen_amount": 2000,
"total_amount": 12000,
"created": 1788998400
}
],
"as_of": 1789084800
}
Global Accounts API
List all accounts and balances for the target merchant
List all accounts and balances for the target merchant
GET
/
api
/
v1
/
account
curl --request GET \
--url "https://api.stablepay.co/api/v1/account" \
--header "Authorization: Bearer <API_KEY>" \
--header "X-StablePay-Timestamp: <TIMESTAMP>" \
--header "X-StablePay-Nonce: <NONCE>" \
--header "X-StablePay-Signature: <SIGNATURE>"
const response = await fetch("https://api.stablepay.co/api/v1/account", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"object": "list",
"data": [
{
"account_no": "00000001",
"account_name": "Default Account",
"currency": "USDT",
"status": "active",
"is_system_default": true,
"editable": false,
"available_amount": 10000,
"frozen_amount": 2000,
"total_amount": 12000,
"created": 1788998400
}
],
"as_of": 1789084800
}
See authentication, signing, data conventions, and errors. Regenerate the timestamp, nonce, and signature on every retry.
GET /account Returns every account and balance for the target merchant; no pagination or filters.
Request headers
string
required
Bearer API Key.
string
required
Unix seconds, within five minutes of server time.
string
required
Unique per request, 16–64 characters.
string
required
Lowercase hexadecimal HMAC-SHA256 signature for the exact request body.
Request parameters
string
10 digits; omit for merchant apps, required for service-provider apps
Response
string
required
Always list
array
required
Array of account objects
integer
required
Observation time
string
required
8-digit account number; keep leading zeros
string
required
Display name
string
required
Currency or asset code
string
required
active or restricted
boolean
required
System default account
boolean
required
Whether renaming is allowed
integer
required
Available balance, smallest unit
integer
required
Frozen or reserved balance
integer
required
Total = available + frozen
integer
required
Creation time, Unix seconds
Status and errors
401 on auth failure; 403 when the app cannot access the merchant.curl --request GET \
--url "https://api.stablepay.co/api/v1/account" \
--header "Authorization: Bearer <API_KEY>" \
--header "X-StablePay-Timestamp: <TIMESTAMP>" \
--header "X-StablePay-Nonce: <NONCE>" \
--header "X-StablePay-Signature: <SIGNATURE>"
const response = await fetch("https://api.stablepay.co/api/v1/account", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"object": "list",
"data": [
{
"account_no": "00000001",
"account_name": "Default Account",
"currency": "USDT",
"status": "active",
"is_system_default": true,
"editable": false,
"available_amount": 10000,
"frozen_amount": 2000,
"total_amount": 12000,
"created": 1788998400
}
],
"as_of": 1789084800
}
Last modified on October 29, 2026
Was this page helpful?
