邀请返佣接口
获取邀请返佣记录
请求示例
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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | |
endTime | long | 否 | |
page | int | 否 | 默认 1 |
recvWindow | long | 否 | |
timestamp | long | 是 | |
signature | string | 是 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
spot | string | 现货返佣,以usdt计 |
futures | string | 合约返佣,以usdt计 |
total | string | 累积奖励金额,以usdt计 |
uid | string | 受邀人UID |
account | string | 受邀人账号 |
inviteTime | long | 邀请时间 |
若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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | |
endTime | long | 否 | |
page | int | 否 | 默认 1 |
recvWindow | long | 否 | |
timestamp | long | 是 | |
signature | string | 是 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
asset | string | 返佣资产,币种 |
type | string | 返佣类型:现货,合约 |
rate | string | 返佣比例 |
amount | string | 返佣金额 |
uid | string | 受邀人UID |
account | string | 受邀人账号 |
tradeTime | long | 用户交易时间 |
updateTime | long | 获取返佣时间 |
若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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | |
endTime | long | 否 | |
page | int | 否 | 默认 1 |
recvWindow | long | 否 | |
timestamp | long | 是 | |
signature | string | 是 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
asset | string | 返佣资产,币种 |
type | string | 返佣类型:现货,合约 |
rate | string | 返佣比例 |
amount | string | 返佣金额 |
uid | string | 受邀人UID |
account | string | 受邀人账号 |
tradeTime | long | 用户交易时间 |
updateTime | long | 获取返佣时间 |
若startTime和endTime均未发送,返回最近一年的数据。
获取邀请人
请求示例
get /api/v3/rebate/referCode?timestamp=1597026383085&signature=abc
返回示例
{
"referCode": "in3jd"
}
HTTP请求
- GET
/api/v3/rebate/referCode
接口权限要求: 账户读 / SPOT_ACCOUNT_R
权重(IP): 1
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
recvWindow | long | 否 | |
timestamp | long | 是 | |
signature | string | 是 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
referCode | string | 邀请人的邀请码,非用户本身的 |
获取代理邀请返佣记录 (代理账户)
请求示例
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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | 开始时间(佣金、入金数据时间) |
endTime | long | 否 | 截止时间(佣金、入金数据时间) |
inviteCode | string | 否 | 邀请码 |
page | int | 否 | 页数 |
pageSize | int | 否 | 页面内容,不传默认10 |
timestamp | long | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
uid | string | 用户uid |
account | string | 邮箱账号(如果是手机号账号,返回null) |
inviteCode | string | 邀请码 |
inviteTime | long | 注册时间 |
spot | string | 现货返佣(usdt) |
etf | string | ETF返佣(usdt) |
futures | string | 合约返佣(usdt) |
total | string | 返佣总额(usdt) |
deposit | string | 已入金金额(usdt) |
firstDepositTime | string | 首次入金日期(若没有,返回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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | 开始时间(佣金、入金数据时间) |
endTime | long | 否 | 截止时间(佣金、入金数据时间) |
page | int | 否 | 页数 |
pageSize | int | 否 | 页面内容,不传默认10 |
timestamp | long | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
withdrawalTime | long | 提现时间 |
asset | string | 提现币种 |
amount | string | 提现金额 |
若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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | 开始时间(佣金、入金数据时间) |
endTime | long | 否 | 截止时间(佣金、入金数据时间) |
inviteCode | string | 否 | 邀请码 |
page | int | 否 | 页数 |
pageSize | int | 否 | 页面内容,不传默认10 |
type | int | 否 | 返佣类型,1:现货、2:合约、3:ETF |
timestamp | long | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
totalCommissionUsdtAmount | string | 总佣金 |
totalTradeUsdtAmount | string | 总交易量 |
type | int | 返佣类型,1:现货、2:合约、3:ETF |
sourceType | int | 1:直客、2:子代理 |
state | int | 返佣状态 |
date | long | 交易日期 |
uid | string | 用户uid |
rate | string | 返佣比例 |
symbol | string | 交易对 |
takerAmount | string | taker金额 |
makerAmount | string | maker金额 |
amountCurrency | string | 金额币种 |
usdtAmount | string | usdt金额 |
commission | string | 返佣金额 |
currency | string | 返佣币种 |
若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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | 开始时间(佣金、入金数据时间) |
endTime | long | 否 | 截止时间(佣金、入金数据时间) |
page | int | 否 | 页数 |
pageSize | int | 否 | 页面内容,不传默认10 |
timestamp | long | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
campaign | string | 活动名称 |
inviteCode | string | 活动邀请码 |
createTime | long | 活动创建时间 |
clickTime | int | 邀请码点击次数 |
signup | int | 注册人数 |
deposited | int | 已入金人数 |
depositAmount | string | 入金量,以usdt计算 |
tradingAmount | string | 交易量,以usdt计算 |
traded | int | 交易人数 |
commission | string | 佣金 |
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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | 开始时间(佣金、入金数据时间) |
endTime | long | 否 | 截止时间(佣金、入金数据时间) |
uid | string | 否 | 直客uid |
inviteCode | string | 否 | 邀请码 |
page | int | 否 | 页数 |
pageSize | int | 否 | 页面内容,不传默认10 |
timestamp | long | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
uid | int | uid |
account | string | 邮箱账号 |
inviteCode | string | 邀请码 |
inviteTime | long | 注册时间 |
nickName | string | 用户昵称,如果无数据返回空白 |
firstDeposit | long | 首次入金时间 |
firstTrade | long | 首次交易时间 |
lastDeposit | long | 最近一次入金时间 |
lastTrade | long | 最近一次交易时间 |
depositAmount | string | 入金量,仅显示数值并统一换算USDT |
tradingAmount | string | 交易量,仅显示数值并统一换算USDT |
amount | string | 佣金,仅显示数值并统一换算USDT |
asset | string | 固定选项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 |
withdrawalAmount | string | 提现金额,仅显示数值并统一换算USDT |
identification | int | 1:未认证、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
请求参数
参数名 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | long | 否 | 开始时间(佣金、入金数据时间) |
endTime | long | 否 | 截止时间(佣金、入金数据时间) |
inviteCode | string | 否 | 邀请码 |
page | int | 否 | 页数 |
pageSize | int | 否 | 页面内容,不传默认10 |
timestamp | long | 是 | 时间戳 |
signature | string | 是 | 签名 |
返回参数
参数名 | 类型 | 说明 |
---|---|---|
subaffiliateName | string | 子代理名称 |
subaffiliateMail | string | 子代理邮箱 |
campaign | string | 子代理注册时的活动 |
inviteCode | string | 子代理注册时的邀请码 |
activationTime | long | 子代理开通时间 |
registered | int | 注册人数 |
deposited | int | 已入金人数 |
depositAmount | string | 入金量 |
commission | string | 佣金 |
startTime、endTime若不填写,则预设查询T-7~T日內数据。