curl --request GET \
--url "https://api.stablepay.co/api/v1/account/{account_no}" \
--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/{account_no}", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"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
Retrieve one account and balance
Retrieve one account and balance
GET
/
api
/
v1
/
account
/
{account_no}
curl --request GET \
--url "https://api.stablepay.co/api/v1/account/{account_no}" \
--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/{account_no}", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"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/{account_no} Returns one account by number with fields at the top level.
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
required
8-digit account number
string
10 digits; omit for merchant apps, required for service-provider apps
Response
string
required
8-digit account number
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
integer
required
Frozen balance
integer
required
Total balance
integer
required
Creation time
integer
required
Observation time
Status and errors
400 malformed number; 404 when missing or owned by another merchant.curl --request GET \
--url "https://api.stablepay.co/api/v1/account/{account_no}" \
--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/{account_no}", {
method: "GET",
headers: {
"Authorization": "Bearer <API_KEY>",
"X-StablePay-Timestamp": "<TIMESTAMP>",
"X-StablePay-Nonce": "<NONCE>",
"X-StablePay-Signature": "<SIGNATURE>"
}
});
console.log(await response.json());
{
"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?