> For the complete documentation index, see [llms.txt](https://hypernexus.gitbook.io/hyper-nexus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hypernexus.gitbook.io/hyper-nexus/usage-and-tutorials.md).

# Usage & Tutorials

### How to Use the Dashboard <a href="#how-to-use-the-dashboard" id="how-to-use-the-dashboard"></a>

The Hyperliquid Stablecoin Dashboard provides a user-friendly interface to monitor multiple stablecoins in real-time. Key usage steps include:

* **Login via Privy** using your preferred method (email, social accounts) to create an embedded wallet without needing an external wallet.
* **View real-time transfer analytics** for supported tokens such as usdxl, kei, feusd, usde, and more.
* **Interact with Human-Readable Identities** via Hyperliquid Names (.hl) displayed across the UI.
* **Access historical and live data through flexible SQL querying** on the backend database.
* **Each token is clickable** taking to dynamic token page for quering transaction fetched from goldsky subgraph

### Telegram Bot Commands (Optional) <a href="#telegram-bot-commands-optional" id="telegram-bot-commands-optional"></a>

For users leveraging the Telegram bot, these commands enhance interaction with pipeline data:

* `/token` — Lists all supported tokens.
* `/recent <token>` — Shows recent transfer transactions.
* `/leaderboard <token>` — Displays top senders.
* `/holders <token>` — Estimates top token holders.
* `/distribution <token>` — Breakdown of wallet size distributions.
* `/activity <token>` — Shows recent transfer activity spikes.
* `/subscribe <token> <usd>` — Subscribes to whale alerts above a USD value.
* `/unsubscribe <token>` — Cancels a whale alert subscription.

***

### How to Subscribe/Unsubscribe Whale Alerts <a href="#how-to-subscribeunsubscribe-whale-alerts" id="how-to-subscribeunsubscribe-whale-alerts"></a>

* Use the bot command `/subscribe <token> <minimum USD>` to receive alerts when whale transfers above the threshold occur.
* Unsubscribe anytime using `/unsubscribe <token>` to stop notifications.

### Query Examples <a href="#query-examples" id="query-examples"></a>

### SQL Query via Postgres

```sql
SELECT from, to, value, timestamp
FROM source_1
ORDER BY timestamp DESC
LIMIT 5;
```

### GraphQL Query via Subgraphs

```graphql
{
  transfers(first: 5, orderBy: timestamp, orderDirection: desc) {
    from
    to
    value
    timestamp
    transactionHash
  }
}
```

### Using Embedded Wallet Features <a href="#using-embedded-wallet-features" id="using-embedded-wallet-features"></a>

* After logging in with Privy, users automatically get an **embedded wallet** created.
* As of now there are no on-chain use case of Embedded Wallet, but future features like minting .hl names and claiming points to store them on chain will be implemented.


---

# 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://hypernexus.gitbook.io/hyper-nexus/usage-and-tutorials.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.
