> For the complete documentation index, see [llms.txt](https://docs-swft.swft.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-swft.swft.pro/zhong-xin-hua-dui-huan-api-jie-kou/overview.md).

# 说明

### 事项注意

1. 中心化兑换接口均需要进行签名鉴权，签名方式，参见相关文档.
2. 中心化接口对接，所有接口应放于服务器端与SWFT进行交互（接口鉴权密钥放于客户端太过危险）
3. 请求方式为 **POST, application/json.**
4. 以下接口中的所用到的币种简称可从  [查询币种列表](https://docs.swft.pro/chang-yong-jie-kou-shuo-ming/coin-list) `api/v1/queryCoinList` 接口返回值中获取.

### 接入中心化兑换方式

#### 1. 非资金抵押方式

用户需要兑换什么币即需要先把币存到SWFT钱包，只能兑换自己已有的币种

**举例子：**

> 用户资产：10000 SWFTC、 0.5 ETH，
>
> 用户可以用 5000SWFTC进行兑换，最多只能拿10000 SWFTC兑换成其他币

#### 2. 资金抵押方式

用户可以用自己没有的币进行兑换，但需要项目方在SWFT 抵押一定数量的主流数字货币，当账户内负资产（借的SWFT的币） -  正资产   超过抵押币数量时，则不再允许兑换，需要继续抵押币或进行清算后才能继续兑换

**举例子：**

> 用户各项资产：0
>
> 用户抵押资产：1 ETH ，抵押实际可用 0.5 ETH
>
> 用户可以用任何币种进行兑换，如 EOS 兑换BTC ，用户可以向SWFT平台借200 EOS 兑换成 0.15 BTC，此时，用户资产为： -200 EOS 、 0.15 BTC，
>
> 假设次数 200EOS折合美元 - 0.15BTC折合美元 > 0.5ETH 折合美元，则该用户无法再向SWFT借币进行兑换，账户会被锁定，无法进行提币、转账、发红包等操作，反之则可以向SWFT继续借币进行兑换

### 中心化兑换和去中心兑换通用接口

1. [查询币种列表](https://docs.swft.pro/chang-yong-jie-kou-shuo-ming/coin-list) `api/v1/queryCoinList`

    2\.  [获取兑换汇率等基本信息](https://docs.swft.pro/chang-yong-jie-kou-shuo-ming/get-base-info)  `api/v1/getBaseInfo`

### 公共请求参数：

| 参数        | 是否必须 | 说明                |
| --------- | ---- | ----------------- |
| channelId | 是    | 渠道ID              |
| sign      | 是    | 签名，签名方式，请详见加密签名文档 |
| timestamp | 是    | 时间戳 毫秒            |

### 公共返回参数：

| 参数      | 是否必须 | 说明              |
| ------- | ---- | --------------- |
| resCode | 是    | 错误码（详见google文档） |
| resMsg  | 是    | 错误信息说明          |
| data    | 否    | 返回数据信息          |