跳轉到

帳戶餘額 Balance

查詢帳戶所有幣種的餘額

GET https://connect.cabital.com/api/v1/accounts/{account_id}/balances

用戶帳號狀態條件

  • 已綁定
  • 已通過實名認證

請求 Path 參數

參數 必填 說明
account_id 是 Cabital 提供的帳號 ID

返回參數

參數 類型 說明
code string 幣種
balances string 剩餘金額
includes array 此幣種餘額下，包含的幣種種類

範例

請求數據

curl "/api/v1/accounts/da781348-1474-4f5f-baf5-676825522835/balances"

返回數據

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "balances": [
        {
            "code": "EUR",
            "balances": "100.00"
        },
        {
            "code": "USDT",
            "balances": "200.172986"
        },
        {
            "code": "USDs",
            "balances": "500.935246",
            "includes": [
                "USD",
                "USDC"
            ]
        },
        {...}
    ]
}

幣種代號

USD stablecoin（USDs）包含 USD、USDC…等各種美元穩定幣，在查詢或 Widget 上顯示餘額時我們會用 USDs 來代表。但要使用兌換或轉帳等交易功能，請使用一般幣種代號，如：USD 或 USDC。

查詢帳戶單一幣種的餘額

GET https://connect.cabital.com/api/v1/accounts/{account_id}/balances/{symbol}

用戶帳號狀態條件

  • 已綁定
  • 已通過實名認證

請求 Path 參數

參數 必填 說明
account_id 是 Cabital 提供的帳號 ID
symbol 是 幣種

返回參數

參數 類型 說明
code string 幣種
balances string 剩餘金額
includes array 此幣種餘額下，包含的幣種種類

範例

請求數據

curl "/api/v1/accounts/6d92e7b4-715c-4ce3-a028-19f1c8c9fa6c/balances/BTC"

返回數據

1
2
3
4
{
  "code": "BTC",
  "balances": "35.57960648"
}