幣種目錄
GET
/cash/v1/merchant/exchange/currencies 鑑權: API Key(Bearer)exchange:read列出全部可交易資產。每條含 symbol、network、name、decimals、contractAddress、isNative、routeCount(可達對手數——0 表示目前不可兌換)、logo 與網路事實(networkName、networkExplorerTxUrl、memo/tag extraFields)。報價與建單時請原樣使用回傳的 symbol / network。
contractAddress 只在資產有已核對的合約地址時出現:原生幣(isNative: true)的資料列沒有 contractAddress 這個鍵,合約地址尚未核對的代幣同樣沒有。請判斷鍵是否存在,不要與 null 比較。
logo 通常是相對 https://www.moin.cash 的路徑,結尾帶 ?v= 版本號,例如 /api/platform-gateway/cash/v1/content/currency-icons/bsc/USDT?v=1789233436149——使用時在前面加上 https://www.moin.cash,並保留查詢字串;圖示變更時版本號隨之變化,可以按完整 URL 長期快取。如果回傳值本身以 https:// 開頭,就是完整位址,原樣使用即可。
同一目錄無需 Key 也可從 GET /cash/v1/content/currencies 讀取。
參數
| 名稱 | 位置 | 類型 | 必填 | 說明 |
|---|---|---|---|---|
| lite | query | boolean | 否 | 只回傳精簡欄位(symbol、network、name、decimals、logo),適合快速選擇器。 |
請求範例
{
"lite": "1"
} 回應範例
{
"ok": true,
"code": 200,
"message": "OK",
"data": [
{
"id": "USDT-bsc",
"symbol": "USDT",
"network": "bsc",
"name": "Tether USD (BNB Smart Chain)",
"decimals": 18,
"contractAddress": "0x55d398326f99059ff775485246999027b3197955",
"isNative": false,
"routeCount": 412,
"logo": "/api/platform-gateway/cash/v1/content/currency-icons/bsc/USDT?v=1789233436149",
"networkName": "BNB Smart Chain",
"networkExplorerTxUrl": "https://bscscan.com/tx/",
"extraFields": [],
"isRecommended": true
},
{
"id": "BNB-bsc",
"symbol": "BNB",
"network": "bsc",
"name": "BNB",
"decimals": 18,
"isNative": true,
"routeCount": 412,
"logo": "/api/platform-gateway/cash/v1/content/currency-icons/bsc/BNB?v=1789233297390",
"networkName": "BNB Smart Chain",
"networkExplorerTxUrl": "https://bscscan.com/tx/",
"extraFields": [],
"isRecommended": true
}
]
}程式碼範例
cURL
curl -X GET 'https://api.moin.cash/cash/v1/merchant/exchange/currencies?lite=1' \
-H 'Authorization: Bearer ck_live_xxxxxxxxxxxxxxxx'