Referral commissions asset

API Spot/Margin API
1

Hello I use /sapi/v1/rebate/taxQuery to fetch referral commission payouts. The problem is the amounts are in BNB while the actual payout is in USDC (I can see it in the all-transaction export via Binance UI) because my European residency. Is it possible to fetch the correct USDC amounts from API?

2

Hi @uiii,

You’re right, when you call /sapi/v1/rebate/taxQuery endpoint, the asset returned is typically in BNB because the API reflects the original comission asset, not necessarily the final payout asset.

Currently, there is no direct API that fetches the converted (USDC) payout for referral commissions.
The Binance website shows the USDC version because of internal conversion rules based on your residency or payout settings, but that conversion is not exposed via public API at this time.

As a workaround you would need to:

  • Fetch the BNB amount via /sapi/v1/rebate/taxQuery
  • Then manually get the historical BNB/USDC price for the payout date
  • And calculate the approximate USDC value yourself.

You can get historical prices using endpoints like /api/v3/klines with the symbol=BNBUSDC.

Let us know if you need further clarification on that!

3

Thanks for explanation. Is it in a roadmap to implement it? Or is there an option to switch back to BNB payouts?

4

Hi @uiii,

As of now, there are no plans to expose the converted (e.g. USDC) referral payout amounts via API.

Regarding switching back to BNB payouts - there isn’t currently a user-facing setting or API to toggle your referral rebate payout asset (e.g., from USDC back to BNB).

Payout asset selection is typically enforced by Binance based on:

  • Your account’s residency
  • Regulatory compliance
  • Binance’s internal policy

If you’d like to request switching back to BNB or inquire about roadmap plans, the best route is to open a support ticket with Binance or submit feedback via the API Support form.