兌換 Convert

POST https://connect.cabital.com/api/v1/accounts/{account_id}/conversions

用戶帳號狀態條件¶

已綁定
已通過實名認證

請求 Path 參數¶

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

請求 Body 參數¶

類型：application/json

參數	必填	類型	說明
`pair`	是	string	兌換的幣種對，格式為 `買入幣種-賣出幣種`（左買右賣）
`quote_id`	是	string	幣種對的報價 ID，為參數 `pair` 透過報價 API 取得的 `quote_id` 參數值
`quote`	是	string	幣種對的報價金額，為參數 `pair` 透過報價 API 取得的 `quote` 參數值
`buy_amount`	是	string	買入數量，並使用對應買入幣種的精度
`sell_amount`	是	string	賣出數量，並使用對應賣出幣種的精度
`major_ccy`	是	string	用戶在兌換介面所輸入的幣種，系統會檢查幣種對應的數量是否符合兌換的數量限制

幣種兌換的數量限制是如何控制的？¶

根據合作方配置 currencies 該幣種 config.conversion 之 min 與 max 的限制

買入或賣出數量計算方式¶

`major_ccy` ＼ `pair`	USDT-EUR	EUR-USDT
USDT	買 USDT 賣 EUR 買入數量乘以報價金額計算賣出數量 `buy_amount*quote = sell_amount`	賣 USDT 買 EUR 賣出數量除以報價金額計算賣出數量 `sell_amount/quote = buy_amount`
EUR	賣 EUR 買 USDT 賣出數量除以報價金額計算賣出數量 `sell_amount/quote = buy_amount`	買 EUR 賣 USDT 買入數量乘以報價金額計算賣出數量 `buy_amount*quote = sell_amount`

返回參數¶

參數	類型	說明
`transaction_id`	string	交易 ID
`status`	string	交易狀態 `SUCCESS`

範例¶

請求數據（買 USDT 賣 EUR）¶

用戶欲買入 100 數量的 USDT，賣出對應數量的 EUR

以幣種對 USDT-EUR 透過報價 API 取得報價

curl "http://connect.cabital.com/api/v1/quotes/USDT-EUR"

{
    "quote": "1.011129",
    "valid_until": 1662101436,
    "quote_id": "20220902065031:USDT-EUR:Customer",
    "valid_interval": 5,
    "reversed_quote": "1.0050453275"
}

計算賣出數量為 100*1.011129 = 101.1129，將此值填入 sell_amount

curl -X POST "http://connect.cabital.com/api/v1/accounts/6d92e7b4-715c-4ce3-a028-19f1c8c9fa6c/conversions" \
-d {
  "quote_id": "20220902065031:USDT-EUR:Customer",
  "quote": "1.011129",
  "pair": "USDT-EUR",
  "buy_amount": "100",
  "sell_amount": "101.1129",
  "major_ccy": "USDT"
}

請求數據（賣 EUR 買 USDT）¶

用戶欲賣出 100 數量的 EUR，買入對應數量的 USDT

以幣種對 USDT-EUR 透過報價 API 取得報價

curl "http://connect.cabital.com/api/v1/quotes/USDT-EUR"

{
    "quote": "1.011129",
    "valid_until": 1662101436,
    "quote_id": "20220902065031:USDT-EUR:Customer",
    "valid_interval": 5,
    "reversed_quote": "1.0050453275"
}

計算買入數量為 100/1.011129 = 98.89934914，將此值填入 buy_amount

curl -X POST "http://connect.cabital.com/api/v1/accounts/6d92e7b4-715c-4ce3-a028-19f1c8c9fa6c/conversions" \
-d {
  "quote_id": "20220902065031:USDT-EUR:Customer",
  "quote": "1.011129",
  "pair": "USDT-EUR",
  "buy_amount": "98.89934914",
  "sell_amount": "100",
  "major_ccy": "EUR"
}

請求數據（賣 USDT 買 EUR）¶

用戶欲賣出 100 數量的 USDT，買入對應數量的 EUR

以幣種對 EUR-USDT 透過報價 API 取得報價

curl "http://connect.cabital.com/api/v1/quotes/EUR-USDT"

{
    "quote": "1.0050453275",
    "valid_until": 1662101436,
    "quote_id": "20220902065031:USDT-EUR:Customer",
    "valid_interval": 5,
    "reversed_quote": "1.011129"
}

計算買入數量為 100/1.0050453275 = 99.498，將此值填入 buy_amount

curl -X POST "http://connect.cabital.com/api/v1/accounts/6d92e7b4-715c-4ce3-a028-19f1c8c9fa6c/conversions" \
-d {
  "quote_id": "20220902065031:USDT-EUR:Customer",
  "quote": "1.0050453275",
  "pair": "EUR-USDT",
  "buy_amount": "99.498",
  "sell_amount": "100",
  "major_ccy": "USDT"
}

請求數據（買 EUR 賣 USDT）¶

用戶欲買入 100 數量的 EUR，賣出對應數量的 USDT

以幣種對 EUR-USDT 透過報價 API 取得報價

curl "http://connect.cabital.com/api/v1/quotes/EUR-USDT"

{
    "quote": "1.0050453275",
    "valid_until": 1662101436,
    "quote_id": "20220902065031:USDT-EUR:Customer",
    "valid_interval": 5,
    "reversed_quote": "1.011129"
}

計算買入數量為 100＊1.0050453275 = 100.50453275，將此值填入 sell_amount

curl -X POST "http://connect.cabital.com/api/v1/accounts/6d92e7b4-715c-4ce3-a028-19f1c8c9fa6c/conversions" \
-d {
  "quote_id": "20220902065031:USDT-EUR:Customer",
  "quote": "1.0050453275",
  "pair": "EUR-USDT",
  "buy_amount": "100",
  "sell_amount": "100.50453275",
  "major_ccy": "USDT"
}