> For the complete documentation index, see [llms.txt](https://docs.multimarkets.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.multimarkets.org/client-api/more.../customer-wallet.md).

# Customer/Wallet

## Add Wallet

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.add\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.add":{"post":{"summary":"Add Wallet","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.add\nAccessible after login","operationId":"add","tags":["Customer/Wallet"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","description":"Wallet Currency"},"chainName":{"type":"string","description":"Chain Name"},"address":{"type":"string","description":"Wallet Address","maxLength":150},"remark":{"type":"string","description":"Wallet Note","maxLength":100},"verifyCode":{"type":"string","description":"Verification code"},"sendToken":{"type":"string","description":"Verification code sending ticket"},"phoneArea":{"type":"string","description":"Phone area code"},"phone":{"type":"string","description":"Phone Number"}},"required":["currency","chainName","address","remark","verifyCode","phoneArea","phone","sendToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResult1"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResult1":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","description":"Data Body","properties":{}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}}}
```

## Add Wallet (MFA)

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.addV1v1v2\
> Accessible after login\
> \
> If the customer enables Google Authenticator (MFA), the Google Authenticator code (googleCode) in the input parameters is required,\
> At the same time, the user does not need to enter a phone number or email,\
> If both phone and email exist, the phone number is verified first

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.addV1v1v2":{"post":{"summary":"Add Wallet (MFA)","deprecated":true,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.addV1v1v2\nAccessible after login\n\nIf the customer enables Google Authenticator (MFA), the Google Authenticator code (googleCode) in the input parameters is required,\nAt the same time, the user does not need to enter a phone number or email,\nIf both phone and email exist, the phone number is verified first","operationId":"addV1v1v2","tags":["Customer/Wallet"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","description":"Wallet Currency"},"chainName":{"type":"string","description":"Chain Name"},"address":{"type":"string","description":"Wallet Address","maxLength":150},"remark":{"type":"string","description":"Wallet Note","maxLength":100},"verifyCode":{"type":"string","description":"Verification code"},"sendToken":{"type":"string","description":"Verification code sending ticket"},"googleCode":{"type":"string","description":"Google Verification Code"}},"required":["currency","chainName","address","remark","verifyCode","sendToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResult1"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResult1":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","description":"Data Body","properties":{}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}}}
```

## Delete Wallet

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.delete\
> Access after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.delete":{"post":{"summary":"Delete Wallet","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.delete\nAccess after login","operationId":"delete","tags":["Customer/Wallet"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Wallet Id","minimum":1}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResult1"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResult1":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","description":"Data Body","properties":{}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}}}
```

## Set default wallet (H5 does not use this interface)

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.updateWallet\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.updateWallet":{"post":{"summary":"Set default wallet (H5 does not use this interface)","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.updateWallet\nAccessible after login","operationId":"updateWallet","tags":["Customer/Wallet"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Wallet Id","minimum":1}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResult1"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResult1":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","description":"Data Body","properties":{}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}}}
```

## Wallet List

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.walletList\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.walletList":{"post":{"summary":"Wallet List","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.walletList\nAccessible after login","operationId":"walletList","tags":["Customer/Wallet"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","description":"Wallet Currency"},"chainName":{"type":"string","description":"Chain Name"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"array","description":"Data Body","items":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Wallet Id"},"currency":{"type":"string","description":"Wallet Currency"},"chainName":{"type":"string","description":"Chain Name"},"address":{"type":"string","description":"Wallet Address"},"remark":{"type":"string","description":"Wallet Note"},"defaultType":{"type":"integer","format":"int32","description":"Default wallet flag 1 yes 0 no"}}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## Add Withdrawal Address (MFA) 

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.addWithdrawalAddressMFA\
> Accessible after login<br>

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.addWithdrawalAddressMFA":{"post":{"summary":"Add Withdrawal Address (MFA) ","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.addWithdrawalAddressMFA\nAccessible after login\n","operationId":"addV1v1v2","tags":["Customer/Wallet"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","description":"Currency"},"chainName":{"type":"string","description":"Withdrawal Network"},"address":{"type":"string","description":"Withdrawal Address","maxLength":150},"remark":{"type":"string","description":"Withdrawal Note","maxLength":40,"minLength":4},"type":{"type":"integer","description":"Type: 1 Email, 2 Phone Number","format":"int32","minimum":1,"maximum":2},"verifyCode":{"type":"string","description":"Verification code, send verification code interface bizType=EMAIL_LOGINED_VERIFICATION_CODE (email), SMS_LOGINED_VERIFICATION_CODE (phone)"},"sendToken":{"type":"string","description":"Verification code sending ticket"},"googleCode":{"type":"string","description":"Google Verification Code"}},"required":["currency","chainName","address","remark","verifyCode","sendToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseResult1"}}},"headers":{}}}}}},"components":{"schemas":{"BaseResult1":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","description":"Data Body","properties":{}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}}}
```

## Query withdrawal address list

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.withdrawalAddressList\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.withdrawalAddressList":{"post":{"summary":"Query withdrawal address list","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.withdrawalAddressList\nAccessible after login","operationId":"walletList","tags":["Customer/Wallet"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","description":"Currency"},"chainName":{"type":"string","description":"Withdrawal Network"}},"required":["currency","chainName"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"array","description":"Data Body","items":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"id"},"currency":{"type":"string","description":"Currency"},"chainName":{"type":"string","description":"Withdrawal Network"},"address":{"type":"string","description":"Withdrawal Address"},"remark":{"type":"string","description":"Withdrawal Note"},"withdrawalAddressStatus":{"type":"integer","format":"int32","description":"Withdrawal address status, 1 enabled, 2 disabled"},"withdrawRiskFailTime":{"type":"integer","description":"Withdrawal address time, risk control expiration time"}}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## Query withdrawal address list (grouped)

> version=0.0.1\
> bizType=customer.app.CustomerWalletWebApiService.withdrawalAddressGroupList\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Wallet"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWalletWebApiService.withdrawalAddressGroupList":{"post":{"summary":"Query withdrawal address list (grouped)","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWalletWebApiService.withdrawalAddressGroupList\nAccessible after login","operationId":"walletList","tags":["Customer/Wallet"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","description":"Currency"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"id"},"currency":{"type":"string","description":"Currency"},"chainName":{"type":"string","description":"Withdrawal Network"},"address":{"type":"string","description":"Withdrawal Address"},"remark":{"type":"string","description":"Withdrawal Note"},"createTime":{"type":"integer","description":"Creation time"}},"description":"Map<Currency, Address List>"},"description":"Data Body"},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```