> ## Documentation Index
> Fetch the complete documentation index at: https://docs.claimr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyperliquid tasks

> Reward real activity on Hyperliquid, from deposits and trading to staking, vaults and referral sign-ups, verified from the wallet the user connected.

## What are Hyperliquid tasks?

Hyperliquid tasks reward activity on Hyperliquid, read from the Ethereum wallet the user signed in to Claimr with. Users don't need to share an API key. The task card shows their progress towards the target and lets them refresh it.

There are 13 Hyperliquid task types:

* **Hyperliquid Deposit**: USDC the user bridged into Hyperliquid over the window. Transfers from other Hyperliquid accounts don't count.
* **Hyperliquid Trading Volume**: Volume the user traded on Hyperliquid perps and spot.
* **Hyperliquid Trades Count**: How many trades (fills) the user made.
* **Hyperliquid PnL**: Realized profit the user made over the window. Open positions don't count, and fees are shown separately rather than subtracted.
* **Hyperliquid Funding Received**: Net funding the user collected on perps: funding received minus funding paid.
* **Hyperliquid Open Position**: The user holds a perp position right now.
* **Hyperliquid Stop Loss / Take Profit**: The user set a stop loss or take profit order. The order doesn't need to trigger.
* **Hyperliquid Trading Streak**: Consecutive days (UTC) the user traded.
* **Hyperliquid Hold Token**: The user holds at least the set amount of a spot token right now, including tokens locked in open orders. Staked HYPE doesn't count here, use the stake task.
* **Hyperliquid Stake HYPE**: HYPE the user has delegated to validators right now.
* **Hyperliquid Vault Deposit**: The user's equity in Hyperliquid vaults right now.
* **Hyperliquid Referral Code**: The user signed up to Hyperliquid with your referral code. A referral is set once per account and never changes, so this proves the account came through you.
* **Hyperliquid Builder Approval**: The user approved your builder address, the one-time signature a Hyperliquid frontend asks for before it can place orders.

<Note>
  Hyperliquid keeps roughly the 10,000 most recent trades per account. Tasks that sum trades can't count older ones. With no window or market set, **Hyperliquid Trading Volume** reads lifetime volume directly, so it isn't affected.
</Note>

## Deposit

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Deposit** from the list of task types.
5. Click **Continue** to proceed to task settings.

USDC the user bridged into Hyperliquid over the window. Transfers from other Hyperliquid accounts don't count.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Amount, USDC:** The amount the user must deposit.
* **Time, h**, **Start at** and **End at (optional):** Count only activity in this window. With none set, all available history counts.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.
* **Is progressive reward?**, **Is continous** and **Max progressive value (optional):** Scale the reward with how many times the user reaches the target, up to the cap.

## Trading volume

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Trading Volume** from the list of task types.
5. Click **Continue** to proceed to task settings.

Volume the user traded on Hyperliquid perps and spot.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Volume, USD:** The volume the user must reach.
* **Market (optional):** Comma separated coins, for example `BTC, HYPE`. Coins on builder-deployed perp dexes match by name too (`TSLA` matches `xyz:TSLA`). Leave it empty for every coin.
* **Maker volume only? (optional):** Count only trades where the user provided liquidity.
* **Time, h**, **Start at** and **End at (optional):** Count only activity in this window. With none set, all available history counts.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.
* **Is progressive reward?**, **Is continous** and **Max progressive value (optional):** Scale the reward with how many times the user reaches the target, up to the cap.

## Trades count

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Trades Count** from the list of task types.
5. Click **Continue** to proceed to task settings.

How many trades (fills) the user made.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Count:** How many trades are needed.
* **Market (optional):** Comma separated coins, for example `BTC, HYPE`. Coins on builder-deployed perp dexes match by name too (`TSLA` matches `xyz:TSLA`). Leave it empty for every coin.
* **Min notional, USD (optional):** Trades smaller than this don't count, so the task can't be farmed with tiny trades.
* **Time, h**, **Start at** and **End at (optional):** Count only activity in this window. With none set, all available history counts.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.
* **Is progressive reward?**, **Is continous** and **Max progressive value (optional):** Scale the reward with how many times the user reaches the target, up to the cap.

## PnL

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid PnL** from the list of task types.
5. Click **Continue** to proceed to task settings.

Realized profit the user made over the window. Open positions don't count, and fees are shown separately rather than subtracted.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **PnL, USD:** The realized profit to reach.
* **Market (optional):** Comma separated coins, for example `BTC, HYPE`. Coins on builder-deployed perp dexes match by name too (`TSLA` matches `xyz:TSLA`). Leave it empty for every coin.
* **Time, h**, **Start at** and **End at (optional):** Count only activity in this window. With none set, all available history counts.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Funding received

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Funding Received** from the list of task types.
5. Click **Continue** to proceed to task settings.

Net funding the user collected on perps: funding received minus funding paid.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Amount, USD:** The net funding to reach.
* **Market (optional):** Comma separated coins, for example `BTC, HYPE`. Coins on builder-deployed perp dexes match by name too (`TSLA` matches `xyz:TSLA`). Leave it empty for every coin.
* **Time, h**, **Start at** and **End at (optional):** Count only activity in this window. With none set, all available history counts.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.
* **Is progressive reward?**, **Is continous** and **Max progressive value (optional):** Scale the reward with how many times the user reaches the target, up to the cap.

## Open position

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Open Position** from the list of task types.
5. Click **Continue** to proceed to task settings.

The user holds a perp position right now.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Count:** How many open positions are needed.
* **Market (optional):** Comma separated coins, for example `BTC, HYPE`. Coins on builder-deployed perp dexes match by name too (`TSLA` matches `xyz:TSLA`). Leave it empty for every coin.
* **Side (optional):** `LONG` or `SHORT`, empty for either.
* **Min notional, USD** and **Min leverage (optional):** Smaller or lower-leverage positions don't count.
* **Perp dex (optional):** A builder-deployed perp dex by name, for example `xyz`. Use `*` for every dex, or leave it empty for Hyperliquid's main perp dex.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Stop loss / take profit

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Stop Loss / Take Profit** from the list of task types.
5. Click **Continue** to proceed to task settings.

The user set a stop loss or take profit order. The order doesn't need to trigger.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Count:** How many orders are needed.
* **Kind (optional):** `STOP_LOSS` or `TAKE_PROFIT`, empty for either.
* **Market (optional):** Comma separated coins, for example `BTC, HYPE`. Coins on builder-deployed perp dexes match by name too (`TSLA` matches `xyz:TSLA`). Leave it empty for every coin.
* **Time, h**, **Start at** and **End at (optional):** Count only activity in this window. With none set, all available history counts.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Trading streak

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Trading Streak** from the list of task types.
5. Click **Continue** to proceed to task settings.

Consecutive days (UTC) the user traded.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Days:** The streak length to reach.
* **Streak mode (optional):** `current` (the default) counts back from today and resets after a day without trading. `longest` is the best streak in the window, earned once and never lost.
* **Min notional, USD (optional):** Trades smaller than this don't keep the streak going.
* **Market (optional):** Comma separated coins, for example `BTC, HYPE`. Coins on builder-deployed perp dexes match by name too (`TSLA` matches `xyz:TSLA`). Leave it empty for every coin.
* **Start at (optional):** Ignore trading before this date.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Hold token

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Hold Token** from the list of task types.
5. Click **Continue** to proceed to task settings.

The user holds at least the set amount of a spot token right now, including tokens locked in open orders. Staked HYPE doesn't count here, use the stake task.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Token:** The spot token ticker, for example `HYPE`.
* **Amount:** The amount the user must hold.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Stake HYPE

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Stake HYPE** from the list of task types.
5. Click **Continue** to proceed to task settings.

HYPE the user has delegated to validators right now.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Amount, HYPE:** The amount that must be staked.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Vault deposit

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Vault Deposit** from the list of task types.
5. Click **Continue** to proceed to task settings.

The user's equity in Hyperliquid vaults right now.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Amount, USD:** The vault equity to reach.
* **Vault address (optional):** One vault, such as HLP or your own. Empty counts every vault.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Referral code

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Referral Code** from the list of task types.
5. Click **Continue** to proceed to task settings.

The user signed up to Hyperliquid with your referral code. A referral is set once per account and never changes, so this proves the account came through you.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Referral code:** The code the user must have signed up with.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.

## Builder approval

1. Go to your quest and click **+ Create new task**.
2. Under the Category section, select **Onchain Actions**.
3. In the Groups list, choose **Hyperliquid**.
4. Select **Hyperliquid Builder Approval** from the list of task types.
5. Click **Continue** to proceed to task settings.

The user approved your builder address, the one-time signature a Hyperliquid frontend asks for before it can place orders.

* **Completion points:** Set the number of points awarded when the user completes the task.
* **Points multiplier (%):** Add a percentage-based bonus to the total reward. Example: a 10% multiplier increases the final reward by 10%.
* **Builder address:** Your frontend's builder address.
* **Trading link (optional):** A link shown under the progress bar, for example to your market.
* **Claim Button Text**, **Refresh Button Text** and **Hide progress? (optional):** Customize the task card.
