Skip to main content

Enable/Disable Mega Coupon

API Description​

This interface allows users to activate and deactivate the Mega Coupon. Mega Coupon funds can be used as margin in futures trading, offseting trading fees, losses, and funding costs.

For more details on Mega Coupon, refer to https://coinw.zendesk.com/hc/en-us/articles/23111150445977-Introduction-to-Futures-Mega-Coupon

Note: Enable/Disable Mega Coupon function is only available via RESTful API.

Precautions​

  1. This interface does not return any information upon a successful request. Receiving (code: 0 ) indicates the request is successful.

    {'code': 0, 'msg': ''}

Authentication​

This is a private interface and requires authentication. For details on using the RESTful API, refer to Introduction > Authentication & Code Snippet > Futures > RESTful Private Interface.

Request Method​

POST

Endpoint​

/v1/perpum/account/almightyGoldInfo

Frequency Limit​

The frequency limit for this interface is 1 requests/2s per user ID and IP. In addition to this per-interface limit, a global rate limit is also enforced.

For detailed information on Global rate limits and API Rate Limiting Policy, please refer to the "Frequency Limit" section at click here

Request Parameters​

ParameterMandatoryTypeDescription
statustrueStringStatus:
1: On
0: Off

Response Parameters​

This interface does not return any information upon a successful request. Receiving (code: 0 ) indicates the request was successful.

{'code': 0, 'msg': ''}

Request Example​

The following Python codes shows how to activate a Mega Coupon.

Note: For a complete code example, please refer to Introduction > Authentication & Code Snippet > Futures > RESTful Private Interface.

params = {"status": 1,}             
 
api_url = "/v1/perpum/account/almightyGoldInfo"
 
method = "POST"
response_code, response_data = FuturesRestfulPrivate(params, api_url, method, sec_key, api_key)    # function FuturesRestfulPrivate() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Private Interface)

Note: For a complete Java code example, please refer to Introduction > Authentication & Code Snippet > Futures > Restful Private Interface.

Response Example​

The following is an example response returned by the above Python request; receiving "code": 0 means success.

{'code': 0, 'msg': ''}