> For the complete documentation index, see [llms.txt](https://uliquid-1.gitbook.io/uliquid-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uliquid-1.gitbook.io/uliquid-docs/support/troubleshooting-and-faq.md).

# Troubleshooting and FAQ

Common issues, diagnostics, and answers to frequent questions.

## Data Is Missing or Not Loading

Check:

* API health.
* Internet and browser connection.
* Exchange account status.
* Last synchronization.
* Runner status.
* Websocket connection.
* Role and workspace.

If only one area is affected, check that feature page and its alerts.

## A Trading Button Is Disabled

Possible causes:

* missing permission,
* re-authentication required,
* degraded live-data signal,
* no exchange account selected,
* missing symbol,
* action already in progress,
* maintenance mode,
* feature not enabled.

## An Order Was Rejected

Check:

* Exchange key permissions.
* Symbol and market type.
* Minimum notional and minimum quantity.
* Margin and leverage.
* Open opposing orders.
* Exchange-specific error message.
* Rate limits.

## A Grid Bot Will Not Start

Check:

* Template preview is ready.
* Budget meets the minimum investment.
* Liquidation distance is not blocked.
* Funding Vault or wallet has enough USDC.
* HYPE is available for gas.
* BotVault provisioning is not pending.
* Runner is active.

## A Wallet Action Stays Pending

Some funding flows confirm only when the destination balance is reached. Wait for indexer or balance refresh and do not start the same flow repeatedly.

## Market Intelligence or AI Is Unavailable

Check your current plan and workspace role first. Then check the feature page for a locked state, provider warning, or exhausted AI-credit notice. A degraded source means the result may be incomplete; use its source references and do not treat it as a trading instruction.

## FAQ

### Does a prediction execute trades automatically?

No. Predictions can prefill the Trading Desk. The order must still be reviewed and confirmed separately.

### Does an exchange key need withdrawal permissions?

No. Withdrawal permissions should not be enabled.

### Why can I not see an admin menu item?

Either the role is missing, the feature gate is off, or you are in the wrong workspace.

### Why do the exchange UI and uLiquid Desk briefly disagree?

Exchange APIs, websockets, indexers, and internal reconciliation can have slightly different timing. If values differ, do not start new live actions and check the exchange UI directly.

### What is a canary?

A small live test with limited capital, clear scope, and close monitoring.

### Can Market Intelligence, Agent Chat, or Position Copilot place a trade?

No. They provide market context, analysis, or risk-oriented recommendations. Any live order remains a separate Trading Desk action that you must review and confirm.


---

# 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://uliquid-1.gitbook.io/uliquid-docs/support/troubleshooting-and-faq.md?ask=<question>&goal=<endgoal>
```

`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.