余额低于指定金额时提醒

PATCHhttps://api.astrum.shop/v1/balance
权限范围 wallet:read

余额低于该金额时,会发送 Telegram 消息(未绑定 Telegram 时发送邮件),并推送 balance.low 事件。只在余额跌破阈值时提醒一次,而不是每笔订单都提醒。

null 表示不提醒。

请求体

application/json
low_balance_alert_usdt
string | null · 必填

USDT 金额:余额低于该金额时,会发送 Telegram 消息或邮件,并推送 balance.low 事件。null 表示不提醒。

响应

balance_usdt
string

当前余额。

daily_spend_limit_usdt
string

每个 UTC 自然日可花费的金额。

available_today_usdt
string

在 UTC 00:00 之前还能花费的金额:取余额与限额剩余部分中的较小值。

low_balance_alert_usdt
string | null

余额低于该金额时提醒;null 表示不提醒。

所有接口通用的错误,详见「错误码」章节:

10001 invalid_key10002 key_scope_missing10003 ip_not_allowed10004 browser_not_allowed10005 account_suspended20001 too_many_requests90002 api_disabled90001 internal_error
测试 USDT,
密钥 ask_test_…
curl https://api.astrum.shop/v1/balance -X PATCH \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "low_balance_alert_usdt": "50.00"
  }'