Spot

Endpoint

Get User’s Customize Id (Spot)

GET

/sapi/v1/apiReferral/userCustomization

https://api.binance.com

Get User’s Customize Id (Spot) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get User’s Customize Id (Spot) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get User’s Customize Id (Spot) › Query Parameters

apiAgentCode

string · required

Example: brokerId

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Get User’s Customize Id (Spot) › Responses

200

Get User’s Customize Id

customerId

string

Example: abc123

Customize Id For Spot Client

POST

/sapi/v1/apiReferral/userCustomization

https://api.binance.com

Customize Id For Spot Client › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Customize Id For Spot Client › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Customize Id For Spot Client › Request Body

customerId

string · required

Example: 1

apiAgentCode

string · required

API agent code

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Customize Id For Spot Client › Responses

200

Customize Id For Client

customerId

string

Example: abc123

Get Client Email Customized Id

GET

/sapi/v1/apiReferral/customization

https://api.binance.com

Get Client Email Customized Id › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get Client Email Customized Id › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get Client Email Customized Id › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

customerId

string

Example: 1

email

string

Example: test12345@126.com

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Client Email Customized Id › Responses

200

Get Client Email Customized Id

object

customerId

string

Example: abc123

email

string

Example: test12345@126.com

Partner Customize Id For Client

POST

/sapi/v1/apiReferral/customization

https://api.binance.com

Partner Customize Id For Client › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Partner Customize Id For Client › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Partner Customize Id For Client › Request Body

customerId

string · required

Example: 1

email

string · required

Example: test12345@126.com

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Partner Customize Id For Client › Responses

200

Customize Id For Client

customerId

string

Example: abc123

email

string

Example: test12345@126.com

Query Client If The New User (Spot)

GET

/sapi/v1/apiReferral/ifNewUser

https://api.binance.com

Query Client If The New User (Spot) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Client If The New User (Spot) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query Client If The New User (Spot) › Query Parameters

apiAgentCode

string · required

Example: brokerId

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Client If The New User (Spot) › Responses

200

Client If The New User

apiAgentCode

string

Example: ABCD1234

rebateWorking

boolean

Example: false

ifNewUser

boolean

Example: true

referrerId

integer · int64

Example: 39472261

Query Rebate Recent Record

GET

/sapi/v1/apiReferral/kickback/recentRecord

https://api.binance.com

Query Rebate Recent Record › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Rebate Recent Record › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

startTime

integer · int64

Timestamp in ms to get funding from INCLUSIVE.

Example: 1623319461670

endTime

integer · int64

Timestamp in ms to get funding until INCLUSIVE.

Example: 1641782889000

limit

integer · int64 · max: 1000

Example: 500

Default: 500

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Rebate Recent Record › Responses

200

Rebate Recent Record

object

income

string

Example: 0.02063898

asset

string

Example: BTC

symbol

string

Example: ETHBTC

time

integer · int64

Example: 1544433328000

Query Partner Rebate Recent Record

GET

/sapi/v1/apiReferral/rebate/recentRecord

https://api.binance.com

Query Partner Rebate Recent Record › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Partner Rebate Recent Record › Query Parameters

startTime

integer · int64 · required

Example: 1623319461670

endTime

integer · int64 · required

Example: 1641782889000

limit

integer · int64 · max: 500 · required

Example: 100

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

customerId

string

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Partner Rebate Recent Record › Responses

200

Rebate Recent Record （USER DATA）

object

customerId

string

Example:

email

string

Example: om***@***.com

income

string

Example: 0.00240635

asset

string

Example: USDC

symbol

string

Example: BNBUSDC

time

integer · int64

Example: 1764000370000

orderId

integer · int64

Example: 54321678

tradeId

integer · int64

Example: 12349876

distributeTime

integer · int64

Example: 1764004848000

commissionAsset

string

Example: BNB

commission

string

Example: 0.00000284

convertPrice

string

Example: 847.30952410

Spot

Endpoint

Download schema

Get User’s Customize Id (Spot)

GET

/sapi/v1/apiReferral/userCustomization

https://api.binance.com

Get User’s Customize Id (Spot) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get User’s Customize Id (Spot) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get User’s Customize Id (Spot) › Query Parameters

apiAgentCode

string · required

Example: brokerId

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Get User’s Customize Id (Spot) › Responses

200

Get User’s Customize Id

customerId

string

Example: abc123

Customize Id For Spot Client

POST

/sapi/v1/apiReferral/userCustomization

https://api.binance.com

Customize Id For Spot Client › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Customize Id For Spot Client › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Customize Id For Spot Client › Request Body

customerId

string · required

Example: 1

apiAgentCode

string · required

API agent code

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Customize Id For Spot Client › Responses

200

Customize Id For Client

customerId

string

Example: abc123

Get Client Email Customized Id

GET

/sapi/v1/apiReferral/customization

https://api.binance.com

Get Client Email Customized Id › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Get Client Email Customized Id › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Get Client Email Customized Id › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

customerId

string

Example: 1

email

string

Example: test12345@126.com

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Client Email Customized Id › Responses

200

Get Client Email Customized Id

object

customerId

string

Example: abc123

email

string

Example: test12345@126.com

Partner Customize Id For Client

POST

/sapi/v1/apiReferral/customization

https://api.binance.com

Partner Customize Id For Client › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Partner Customize Id For Client › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Partner Customize Id For Client › Request Body

customerId

string · required

Example: 1

email

string · required

Example: test12345@126.com

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Partner Customize Id For Client › Responses

200

Customize Id For Client

customerId

string

Example: abc123

email

string

Example: test12345@126.com

Query Client If The New User (Spot)

GET

/sapi/v1/apiReferral/ifNewUser

https://api.binance.com

Query Client If The New User (Spot) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Client If The New User (Spot) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Query Client If The New User (Spot) › Query Parameters

apiAgentCode

string · required

Example: brokerId

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Client If The New User (Spot) › Responses

200

Client If The New User

apiAgentCode

string

Example: ABCD1234

rebateWorking

boolean

Example: false

ifNewUser

boolean

Example: true

referrerId

integer · int64

Example: 39472261

Query Rebate Recent Record

GET

/sapi/v1/apiReferral/kickback/recentRecord

https://api.binance.com

Query Rebate Recent Record › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Rebate Recent Record › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

startTime

integer · int64

Timestamp in ms to get funding from INCLUSIVE.

Example: 1623319461670

endTime

integer · int64

Timestamp in ms to get funding until INCLUSIVE.

Example: 1641782889000

limit

integer · int64 · max: 1000

Example: 500

Default: 500

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Rebate Recent Record › Responses

200

Rebate Recent Record

object

income

string

Example: 0.02063898

asset

string

Example: BTC

symbol

string

Example: ETHBTC

time

integer · int64

Example: 1544433328000

Query Partner Rebate Recent Record

GET

/sapi/v1/apiReferral/rebate/recentRecord

https://api.binance.com

Query Partner Rebate Recent Record › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Query Partner Rebate Recent Record › Query Parameters

startTime

integer · int64 · required

Example: 1623319461670

endTime

integer · int64 · required

Example: 1641782889000

limit

integer · int64 · max: 500 · required

Example: 100

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

customerId

string

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Partner Rebate Recent Record › Responses

200

Rebate Recent Record （USER DATA）

object

customerId

string

Example:

email

string

Example: om***@***.com

income

string

Example: 0.00240635

asset

string

Example: USDC

symbol

string

Example: BNBUSDC

time

integer · int64

Example: 1764000370000

orderId

integer · int64

Example: 54321678

tradeId

integer · int64

Example: 12349876

distributeTime

integer · int64

Example: 1764004848000

commissionAsset

string

Example: BNB

commission

string

Example: 0.00000284

convertPrice

string

Example: 847.30952410