# 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":{}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.multimarkets.org/client-api/more.../customer-wallet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.