技能名称: sardis-balance

Sardis Balance - 只读钱包分析

安全、只读的技能，用于检查钱包余额、支出摘要和交易历史。非常适合在无支付执行风险的情况下进行监控。

功能

• - 余额检查：所有支持链上的实时钱包余额
• 支出摘要：每日、每周、每月的支出分析
• 交易历史：带有筛选功能的完整审计追踪
• 预算追踪：每日/每周/每月剩余限额
• 多钱包：检查多个代理钱包的余额

安全模型

只读：此技能无法执行支付或修改钱包状态。可安全地无限制使用。

快速设置

bash
export SARDISAPIKEY=skyourkey_here

注意：无需 WALLET_ID - 可查询您有权访问的任何钱包。

API 端点模式

基础 URL：https://api.sardis.sh/v2

检查钱包余额

bash

获取特定钱包的当前余额

curl -X GET https://api.sardis.sh/v2/wallets/{wallet_id}/balance \
-H Authorization: Bearer $SARDISAPIKEY

示例响应：

{

walletid: walletabc123,

balances: {

base: {USDC: 1250.00, EURC: 500.00},

polygon: {USDC: 750.00}

},

total_usd: 2500.00

}

支出摘要

bash

获取某个时间段的支出摘要

curl -X GET https://api.sardis.sh/v2/wallets/{wallet_id}/spending/summary?period=day \
-H Authorization: Bearer $SARDISAPIKEY

可用时间段：hour, day, week, month, year

交易历史

bash

列出带有筛选条件的近期交易

curl -X GET https://api.sardis.sh/v2/wallets/{wallet_id}/transactions?limit=20&status=completed \
-H Authorization: Bearer $SARDISAPIKEY

筛选条件：

- limit: 交易数量（默认10，最大100）

- status: completed, pending, failed

- from_date: ISO 8601 时间戳

- to_date: ISO 8601 时间戳

- min_amount: 最小交易金额

- max_amount: 最大交易金额

按供应商支出

bash

获取按供应商划分的支出明细

curl -X GET https://api.sardis.sh/v2/wallets/{wallet_id}/spending/by-vendor?period=month \
-H Authorization: Bearer $SARDISAPIKEY

返回按支出金额排序的顶级供应商

剩余预算

bash

检查相对于策略限额的剩余预算

curl -X GET https://api.sardis.sh/v2/wallets/{wallet_id}/budget/remaining \
-H Authorization: Bearer $SARDISAPIKEY

示例响应：

{

daily_limit: 500.00,

daily_spent: 325.00,

daily_remaining: 175.00,

weekly_limit: 2000.00,

weekly_spent: 1200.00,

weekly_remaining: 800.00

}

示例命令

快速余额检查

bash

单个钱包余额

WALLETID=walletabc123
curl -s -X GET https://api.sardis.sh/v2/wallets/$WALLET_ID/balance \
-H Authorization: Bearer $SARDISAPIKEY | jq .total_usd

每日支出报告

bash

获取今日支出及供应商明细

WALLETID=walletabc123

echo === 每日支出报告 ===
curl -s -X GET https://api.sardis.sh/v2/wallets/$WALLET_ID/spending/summary?period=day \
-H Authorization: Bearer $SARDISAPIKEY | jq .

echo -e \n=== 顶级供应商 ===
curl -s -X GET https://api.sardis.sh/v2/wallets/$WALLET_ID/spending/by-vendor?period=day \
-H Authorization: Bearer $SARDISAPIKEY | jq .vendors[] | \(.name): $\(.amount)

多钱包仪表盘

bash

检查多个钱包的余额

for wallet in walletabc123 walletdef456 wallet_ghi789; do
echo 钱包: $wallet
curl -s -X GET https://api.sardis.sh/v2/wallets/$wallet/balance \
-H Authorization: Bearer $SARDISAPIKEY | jq .total_usd
echo ---
done

预算警报检查

bash

检查是否接近支出限额

WALLETID=walletabc123
REMAINING=$(curl -s -X GET https://api.sardis.sh/v2/wallets/$WALLET_ID/budget/remaining \
-H Authorization: Bearer $SARDISAPIKEY | jq -r .daily_remaining)

if (( $(echo $REMAINING < 100 | bc -l) )); then
echo 警告：每日预算仅剩 $REMAINING
fi

响应示例

余额响应

json
{
walletid: walletabc123,
agentid: agentxyz789,
balances: {
base: {
USDC: 1250.00,
EURC: 500.00
},
polygon: {
USDC: 750.00,
USDT: 250.00
}
},
total_usd: 2750.00,
last_updated: 2026-02-21T10:30:00Z
}

支出摘要响应

json
{
period: day,
start_date: 2026-02-21T00:00:00Z,
end_date: 2026-02-21T23:59:59Z,
total_spent: 325.00,
transaction_count: 12,
average_transaction: 27.08,
largest_transaction: 75.00,
by_chain: {
base: 200.00,
polygon: 125.00
},
by_token: {
USDC: 275.00,
USDT: 50.00
}
}

交易历史响应

json
{
transactions: [
{
id: tx_abc123,
walletid: walletabc123,
to: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb,
amount: 25.00,
token: USDC,
chain: base,
status: completed,
purpose: OpenAI API credits,
tx_hash: 0x1234...,
created_at: 2026-02-21T09:15:00Z,
completed_at: 2026-02-21T09:15:30Z
}
],
total: 47,
page: 1,
limit: 20
}

错误处理

• - 401 Unauthorized - API 密钥无效或缺失
• 403 Forbidden - 无权访问此钱包
• 404 Not Found - 钱包不存在
• 429 Too Many Requests - 超出速率限制

用例

• - 预算监控：追踪代理支出与限额的对比
• 异常检测：识别异常支出模式
• 多代理仪表盘：监控代理钱包集群
• 合规报告：生成用于审计的支出报告
• 警报系统：在预算阈值触发时发送通知

相关技能

• - sardis-payment - 执行支付并管理钱包
• sardis-policy - 创建和管理支出策略
• sardis-cards - 虚拟卡管理

链接

• - 网站：https://sardis.sh
• 文档：https://sardis.sh/docs/balance-api
• API 参考：https://api.sardis.sh/v2/docs
• 支持：support@sardis.sh