跳到主要内容

邀请返佣接口

获取邀请返佣记录

请求示例

get /api/v3/rebate/taxQuery?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
   "page": 1, //当前页
   "totalRecords": 1, //总记录数
   "totalPageNum": 1, //总页数
   "data": [
      {
          "spot": "0.00082273", // 现货返佣,以usdt计
          "futures":"0.00022487",       // 合约返佣,以usdt计
          "total": "0.00012126", //累积奖励金额,以usdt计
          "uid": "221827", // 受邀人UID
          "account": "154****291@qq.com", // 受邀人账号
          "inviteTime": 1637651320000//邀请时间
      },
      ...
      {
          "spot": "0.00082273", // 现货返佣,以usdt计
          "futures":"0.00022487",       // 合约返佣,以usdt计
          "total": "0.00012126", //累积奖励金额,以usdt计
          "uid": "82937", // 受邀人UID
          "account": "338****291@qq.com", // 受邀人账号
          "inviteTime": 1637651320000//邀请时间
      }
   ]
}

HTTP请求

  • GET /api/v3/rebate/taxQuery

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong
endTimelong
pageint默认 1
recvWindowlong
timestamplong
signaturestring

返回参数

参数名类型说明
spotstring现货返佣,以usdt计
futuresstring合约返佣,以usdt计
totalstring累积奖励金额,以usdt计
uidstring受邀人UID
accountstring受邀人账号
inviteTimelong邀请时间

若startTime和endTime均未发送,返回最近一年的数据。

获取返佣记录明细 (奖励记录)

请求示例

get /api/v3/rebate/detail?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
    "page": 1, //当前页
    "totalRecords": 1, //总记录数
    "totalPageNum": 1, //总页数
    "data": [
        {
            "asset": "USDT", // 返佣资产,币种
            "type": "spot",       // 返佣类型:现货,合约
            "rate": "0.3", // 返佣比例
            "amount": "0.0001126", // 返佣金额
            "uid": "2293729101827", // 受邀人UID
            "account": "154****291@qq.com", // 受邀人账号
            "tradeTime": 1637651320000,//用户交易时间
            "updateTime": 1637651320000//获取返佣时间
        },
        ...
        {
            "asset": "ETH", // 返佣资产,币种
            "type": "spot", // 返佣类型:现货,合约
            "rate": "0.3", // 返佣比例
            "amount": "0.00000056",// 返佣金额
            "uid": "22937291018263", // 受邀人UID
            "account": "154****291@qq.com", // 受邀人账号
            "tradeTime": 1637651320000,//用户交易时间
            "updateTime": 1637928379000//获取返佣时间
        }
    ]
}

HTTP请求

  • GET /api/v3/rebate/detail

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong
endTimelong
pageint默认 1
recvWindowlong
timestamplong
signaturestring

返回参数

参数名类型说明
assetstring返佣资产,币种
typestring返佣类型:现货,合约
ratestring返佣比例
amountstring返佣金额
uidstring受邀人UID
accountstring受邀人账号
tradeTimelong用户交易时间
updateTimelong获取返佣时间

若startTime和endTime均未发送,返回最近一年的数据。

获取自返记录明细 (奖励记录)

请求示例

get /api/v3/rebate/detail/kickback?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
   "page": 1, //当前页
   "totalRecords": 27, //总记录数
   "totalPageNum": 3, //总页数
   "data": [
      {
          "asset": "USDT", // 返佣资产,币种
          "type": "spot",       // 返佣类型:现货,合约
          "rate": "0.3", // 返佣比例
          "amount": "0.0001126", // 返佣金额
          "uid": "2293729101827", // 受邀人UID
          "account": "154****291@qq.com", // 受邀人账号
          "tradeTime": 1637651320000,//用户交易时间
          "updateTime": 1637651320000//获取返佣时间
      },
      ...
      {
          "asset": "ETH", // 返佣资产,币种
          "type": "spot", // 返佣类型:现货,合约
          "rate": "0.3", // 返佣比例
          "amount": "0.00000056",// 返佣金额
          "uid": "22937291018263", // 受邀人UID
          "account": "154****291@qq.com", // 受邀人账号
          "tradeTime": 1637651320000,//用户交易时间
          "updateTime": 1637928379000//获取返佣时间
      }
   ]
}

HTTP请求

  • GET /api/v3/rebate/detail/kickback

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong
endTimelong
pageint默认 1
recvWindowlong
timestamplong
signaturestring

返回参数

参数名类型说明
assetstring返佣资产,币种
typestring返佣类型:现货,合约
ratestring返佣比例
amountstring返佣金额
uidstring受邀人UID
accountstring受邀人账号
tradeTimelong用户交易时间
updateTimelong获取返佣时间

若startTime和endTime均未发送,返回最近一年的数据。

获取邀请人

请求示例

get /api/v3/rebate/referCode?timestamp=1597026383085&signature=abc

返回示例

{
"referCode": "in3jd"
}

HTTP请求

  • GET /api/v3/rebate/referCode

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
recvWindowlong
timestamplong
signaturestring

返回参数

参数名类型说明
referCodestring邀请人的邀请码,非用户本身的

获取代理邀请返佣记录 (代理账户)

请求示例

get /api/v3/rebate/affiliate/commission?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
"success": true,
"code": 0,
"message": null,
"data": {
"pageSize": 10,
"totalCount": 2,
"totalPage": 1,
"currentPage": 1,
"usdtAmount": null,
"totalCommissionUsdtAmount": null,
"totalTradeUsdtAmount": null,
"finished": null,
"resultList": [
{
"uid": "27121050",
"account": "",
"inviteCode": "mexc-12345",
"inviteTime": 1637145911,
"spot": "0.00000000",
"etf": "0.21131086",
"futures": "0.74546367",
"total": "0.95677453",
"deposit": null,
"firstDepositTime": null
},
{
"uid": "52813530",
"account": "",
"inviteCode": "mexc-12345",
"inviteTime": 1637145478,
"spot": "1.25023599",
"etf": "0.00000000",
"futures": "0.00000000",
"total": "1.25023599",
"deposit": "26000.00000000",
"firstDepositTime": "2021-11-19"
}
]
}
}

HTTP请求

  • GET /api/v3/rebate/affiliate/commission

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong开始时间(佣金、入金数据时间)
endTimelong截止时间(佣金、入金数据时间)
inviteCodestring邀请码
pageint页数
pageSizeint页面内容,不传默认10
timestamplong时间戳
signaturestring签名

返回参数

参数名类型说明
uidstring用户uid
accountstring邮箱账号(如果是手机号账号,返回null)
inviteCodestring邀请码
inviteTimelong注册时间
spotstring现货返佣(usdt)
etfstringETF返佣(usdt)
futuresstring合约返佣(usdt)
totalstring返佣总额(usdt)
depositstring已入金金额(usdt)
firstDepositTimestring首次入金日期(若没有,返回null)

若startTime和endTime均未发送,返回最近半年的数据。

获取代理提现记录 (代理账户)

请求示例

get /api/v3/rebate/affiliate/withdraw?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
"success": true,
"code": 0,
"message": null,
"data": {
"pageSize": 10,
"totalCount": 15,
"totalPage": 2,
"currentPage": 1,
"resultList": [
{
"withdrawTime": 1682321417000,
"asset": "USDT",
"amount": "0.00001000"
},
{
"withdrawTime": 1682321405000,
"asset": "USDC",
"amount": "0.00001000"
}
]
}
}


HTTP请求

  • GET /api/v3/rebate/affiliate/withdraw

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong开始时间(佣金、入金数据时间)
endTimelong截止时间(佣金、入金数据时间)
pageint页数
pageSizeint页面内容,不传默认10
timestamplong时间戳
signaturestring签名

返回参数

参数名类型说明
withdrawalTimelong提现时间
assetstring提现币种
amountstring提现金额

若startTime和endTime均未发送,返回最近半年的数据。

获取代理返佣明细 (代理账户)

请求示例

get /api/v3/rebate/affiliate/commission/detail?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
"success": true,
"code": 0,
"message": null,
"data": {
"pageSize": 10,
"totalCount": 5,
"totalPage": 1,
"currentPage": 1,
"totalCommissionUsdtAmount": "0.0011",
"totalTradeUsdtAmount": "281.8096",
"resultList": [
{
"type": 2,
"sourceType": 2,
"state": 2,
"date": 1689264000000,
"uid": "17875073",
"rate": 0.1,
"symbol": "USDT",
"takerAmount": "170.49326",
"makerAmount": "0",
"amountCurrency": "USDT",
"usdtAmount": "170.49326",
"commission": "0.00085246",
"currency": "USDT"
}
]
}
}


HTTP请求

  • GET /api/v3/rebate/affiliate/commission/detail

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong开始时间(佣金、入金数据时间)
endTimelong截止时间(佣金、入金数据时间)
inviteCodestring邀请码
pageint页数
pageSizeint页面内容,不传默认10
typeint返佣类型,1:现货、2:合约、3:ETF
timestamplong时间戳
signaturestring签名

返回参数

参数名类型说明
totalCommissionUsdtAmountstring总佣金
totalTradeUsdtAmountstring总交易量
typeint返佣类型,1:现货、2:合约、3:ETF
sourceTypeint1:直客、2:子代理
stateint返佣状态
datelong交易日期
uidstring用户uid
ratestring返佣比例
symbolstring交易对
takerAmountstringtaker金额
makerAmountstringmaker金额
amountCurrencystring金额币种
usdtAmountstringusdt金额
commissionstring返佣金额
currencystring返佣币种

若startTime和endTime均未发送,返回T-7~T的日期(近8天內日期)的数据,type不填则返回全部种类数据。

获取代理活动页面数据 (代理账户)

请求示例

get /api/v3/rebate/affiliate/campaign?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
"success": true,
"code": 0,
"message": null,
"data": {
"pageSize": 10,
"totalCount": 15,
"totalPage": 2,
"currentPage": 1,
"resultList": [
{
"campaign": "11kd",
"inviteCode": "mexc-11Kd",
"clickTime": 0,
"createTime": 1695125287000,
"signup": 0,
"traded": 0,
"deposited": 0,
"depositAmount": "0",
"tradingAmount": "0",
"commission": "0"
},
{
"campaign": "New10",
"inviteCode": "mexc-newcode",
"clickTime": 7,
"createTime": 1693152531000,
"signup": 0,
"traded": 0,
"deposited": 0,
"depositAmount": "0",
"tradingAmount": "0",
"commission": "0"
}
]
}
}


HTTP请求

  • GET /api/v3/rebate/affiliate/campaign

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong开始时间(佣金、入金数据时间)
endTimelong截止时间(佣金、入金数据时间)
pageint页数
pageSizeint页面内容,不传默认10
timestamplong时间戳
signaturestring签名

返回参数

参数名类型说明
campaignstring活动名称
inviteCodestring活动邀请码
createTimelong活动创建时间
clickTimeint邀请码点击次数
signupint注册人数
depositedint已入金人数
depositAmountstring入金量,以usdt计算
tradingAmountstring交易量,以usdt计算
tradedint交易人数
commissionstring佣金

startTime、endTime若不填写,则预设查询T-7~T日內数据。

查询直客页面数据(代理账户)

请求示例

get /api/v3/rebate/affiliate/referral?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
"success": true,
"code": 0,
"message": null,
"data": {
"pageSize": 10,
"totalCount": 15,
"totalPage": 2,
"currentPage": 1,
"resultList": [
{
"uid": "42469975",
"nickName": null,
"email": "",
"registerTime": 1640275818000,
"inviteCode": "mexc-12201950",
"depositAmount": "0.00000000",
"tradingAmount": "0.00000000",
"commission": "0.00000000",
"firstDepositTime": null,
"firstTradeTime": null,
"lastDepositTime": null,
"lastTradeTime": null,
"withdrawAmount": "0.00000000",
"asset": "0 USDT",
"identification": 1
}
]
}
}


HTTP请求

  • GET /api/v3/rebate/affiliate/referral

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong开始时间(佣金、入金数据时间)
endTimelong截止时间(佣金、入金数据时间)
uidstring直客uid
inviteCodestring邀请码
pageint页数
pageSizeint页面内容,不传默认10
timestamplong时间戳
signaturestring签名

返回参数

参数名类型说明
uidintuid
accountstring邮箱账号
inviteCodestring邀请码
inviteTimelong注册时间
nickNamestring用户昵称,如果无数据返回空白
firstDepositlong首次入金时间
firstTradelong首次交易时间
lastDepositlong最近一次入金时间
lastTradelong最近一次交易时间
depositAmountstring入金量,仅显示数值并统一换算USDT
tradingAmountstring交易量,仅显示数值并统一换算USDT
amountstring佣金,仅显示数值并统一换算USDT
assetstring固定选项9种: 0 USDT、1-1,000 USDT、1,000 - 10,000 USDT、 10,000 - 50,000 USDT、50,000 - 100,000 USDT、 100,000 - 500,000 USDT、500,000 - 1,000,000 USDT、 1,000,000 - 5,000,000 USDT、>5,000,000 USDT
withdrawalAmountstring提现金额,仅显示数值并统一换算USDT
identificationint1:未认证、2:初级、3:高级、4:机构

startTime、endTime若不填写,则预设查询T-7~T日內数据。

查询子代理页面数据(代理账户)

请求示例

get /api/v3/rebate/affiliate/subaffiliates?timestamp={{timestamp}}&signature={{signature}}

返回示例

{
"success": true,
"code": 0,
"message": null,
"data": {
"pageSize": 10,
"totalCount": 15,
"totalPage": 2,
"currentPage": 1,
"resultList": [
{
"subaffiliateName": "ada176@mailtemp.top ada176",
"subaffiliateMail": "ad*****6@mailtemp.top",
"campaign": "new1",
"inviteCode": "mexc-12181621",
"activationTime": 1639834136000,
"registered": 0,
"deposited": 0,
"depositAmount": "0",
"commission": "0"
},
{
"subaffiliateName": "ada165@mailtemp.top ada165",
"subaffiliateMail": "ad*****5@mailtemp.top",
"campaign": null,
"inviteCode": "1KMyk",
"activationTime": 1639831541000,
"registered": 0,
"deposited": 1,
"depositAmount": "21.15318",
"commission": "0.5161221"
}
]
}
}


HTTP请求

  • GET /api/v3/rebate/affiliate/subaffiliates

接口权限要求: 账户读 / SPOT_ACCOUNT_R

权重(IP): 1

请求参数

参数名数据类型是否必须说明
startTimelong开始时间(佣金、入金数据时间)
endTimelong截止时间(佣金、入金数据时间)
inviteCodestring邀请码
pageint页数
pageSizeint页面内容,不传默认10
timestamplong时间戳
signaturestring签名

返回参数

参数名类型说明
subaffiliateNamestring子代理名称
subaffiliateMailstring子代理邮箱
campaignstring子代理注册时的活动
inviteCodestring子代理注册时的邀请码
activationTimelong子代理开通时间
registeredint注册人数
depositedint已入金人数
depositAmountstring入金量
commissionstring佣金

startTime、endTime若不填写,则预设查询T-7~T日內数据。