> For the complete documentation index, see [llms.txt](https://unicornx-ai.gitbook.io/unicornx.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unicornx-ai.gitbook.io/unicornx.ai/referral-withdrawal-guide.md).
# Referral Withdrawal Guide
* Eligibility/Threshold: All users can withdraw; no minimum amount. If the amount is too small to cover on-chain gas, the system will prompt you to deposit and try again.
* Withdraw Address: The system automatically uses your MPC wallet address (no manual input needed).
* Fees and Arrival: On-chain withdrawals incur gas; final received amount is subject to the chain. You can check progress and tx hash in the withdrawal history.
{% hint style="warning" %}
Common block: If gas is insufficient, you'll see "Wallet balance is insufficient to pay the gas fee. Please deposit a small amount of BNB and try again." Deposit a small amount and retry.
{% endhint %}
***
## ๐ฑ App: Complete Withdrawal in 3 Steps
### Step 1 | Enter the Referral page and confirm "Pending Withdraw"
1. Open the App Home โ \[My Earnings] Referral page.
2. Check the two numbers at the top:
* Total Commission: Includes withdrawn + pending; no withdraw button here.
* Pending Withdraw: Shows only unclaimed amount; when Pending Withdraw > 0, the withdraw button is active; otherwise greyed out.
3. Tap the icon on the upper right of Pending Withdraw to view withdrawal history (for reconciliation).
{% hint style="info" %}
Only when a token amount in "Pending Withdraw" is withdrawable will the withdraw button activate. The middle BNB / SOL / USDTโฆ list shows the withdrawable amounts per token.
{% endhint %}
### Step 2 | Tap Withdraw and verify the modal details
1. Tap the highlighted "Withdraw" button to open the withdraw modal.
2. The modal shows:
* Withdraw Address: Your MPC wallet address (auto-populated).
* Network: Mainnet by default; not switchable.
* Amount: A list of withdrawable amounts for all supported tokens on the platform (displayed per token).
* Operation: Withdraw per token. After tapping a token's "Withdraw" button, the system withdraws the entire available amount of that token to your wallet at once.
{% hint style="success" %}
Arrival note: Referral rewards are withdrawn to your wallet; after completion, check your balance on the Assets page. On-chain withdrawals include gas; final amount is subject to the chain.
{% endhint %}
### Step 3 | Handle prompts and results
* If gas is insufficient: A toast shows "Wallet balance is insufficient to pay the gas fee. Please deposit a small amount of BNB and try again." Deposit a small amount of the native token (e.g., BNB) in the corresponding network, then retry.
* If submitted successfully: The modal closes and a toast shows "Withdrawal initiated. You can view details in \[Withdrawal History]."
* After arrival: Go to the Assets section to see the updated balance.
***
## ๐งพ App: How to view \[Withdrawal History]
1. On the Referral page, tap "Withdrawal History" at the bottom to open the details page.
2. Fields and rules:
* Time, Network, Amount, Hash (copyable); displayed in reverse chronological order.
* Withdrawing multiple assets on the same chain in one go may produce multiple records.
* Recorded upon initiation: Even if the on-chain tx is not confirmed yet, a record appears; the Hash will show "Pending Update".
* Failed records are labeled "Failed".
***
## ๐ป PC: Withdrawal process synced with App
The PC flow is consistent with the App, with identical logic and shared data. The difference is layout.
### Step 1 | Enter the Referral page and review the two sections
* Open the \[Referral] page via the button next to the language switch (three-dots menu).
* Pending Withdraw (expanded by default): Shows withdrawable amounts per token with a "Withdraw" button.
* Total Earnings: Shows historical accumulated commissions, with no withdraw button.
* Both sections support expand/collapse; only one is expanded at a time.
### Step 2 | Submit withdrawal
* In the "Pending Withdraw" section, click Withdraw to trigger MPC address signing and complete the withdrawal.
* Prompt texts match the App:
* Success โ "Withdrawal initiated. You can view details in \[Withdrawal History]."
* Insufficient gas โ "Wallet balance is insufficient to pay the gas fee. Please deposit a small amount of BNB and try again."
### Step 3 | View history (PC)
* "Withdrawal History" is at the bottom of the Referral page as the third tab.
* Fields are consistent with the App: Time / Network / Amount / Hash (copyable).
***
## ๐ FAQ and Troubleshooting
### Q1: The Withdraw button is greyed out. What should I do?
* It means the pending amount is 0, or there's no withdrawable balance for the current chain/token. Wait for new commissions or switch to a token with balance and retry.
### Q2: It says gas is insufficient. How to fix?
* Deposit a small amount of the native token to your wallet on the corresponding network (e.g., BSC โ BNB), then initiate the withdrawal again.
### Q3: Hash keeps showing "Pending Update" in history?
* It means the on-chain transaction is not yet confirmed or the system hasn't populated the hash. Once confirmed, it will auto-update to the final hash. If it takes long, refresh and check later.
### Q4: Can I customize the withdraw address?
* Not supported. Referral withdrawals go to your MPC wallet automatically, eliminating the risk of mis-entered addresses
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://unicornx-ai.gitbook.io/unicornx.ai/referral-withdrawal-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.