Prompt Engineering

In this section, you can find a complete list of the commands that Helva is capable of executing. Thanks to its proprietary "Plan-To-Execute" architecture, each command can be freely combined with any other, enabling complex, multi-step strategy execution.

For simplicity, we divide the commands into two main categories:

  • Basic Prompts This includes all the core functions that users can trigger individually, such as swaps, deposits, withdrawals, staking, or retrieving price/APR information.

  • Advanced Prompts These refer to all commands that activate more complex DeFi strategies, where Helva can autonomously plan and execute optimized workflows (e.g., leverage loops, risk/reward analysis, cross-protocol asset management).

Basic Prompts

Please note:

  1. Token In Amount can be a Numerical Value (1,10,100 etc.) or can be a proportion to you balance (All, Half of my Balance etc.)

  2. Gas is autonomously handled by Helva. It's calculated with eth_estimateGas, then 50% buffer is added, then based on which type of function is called (swap, liquidity in etc.) - Helva checks if it's above a certain threshold.

  3. Here, we actively keep track of the development. Tools integrated are marked by a green emoji, Tools under integration yellow, Tools which integration is To Be Determined red.

Basic Functions🟢

Swaps use Quickswap V3 liquidity pools and the Algebra DEX architecture. Once the pair and the input amount are determined, the output token amount is estimated and the swap is executed with the goal of maximizing the output. In addition, Helva integrates smart routing. If a swap is executed between two tokens for which no liquidity pool exists, Helva will find the most efficient route to swap Token A into Token B.

Function Name
Input Parameters
Examples

Swap

TOKEN_A_AMOUNT_IN TOKEN_IN_SYMBOL TOKEN_OUT_SYMBOL

  1. Swap 10 POL for USDC

  2. Swap half of my QUICK for USDT

Send

TOKEN_TO_SEND TOKE_AMOUNT RECEIVER_ADDRESS

Send 10 POL to 0x..32A

Fetch Token Balance

TOKEN_SYMBOL

  1. Can you fetch my POL Balance?

  2. Can you fetch my POL and USDC balances?

LPs Management 🟢

Helva uses Quickswap V3 and the Algebra DEX architecture to manage user positions in Liquidity Pools. When opening a new position, it will automatically be created in the Common Liquidity Range (-20%, +40%). If you wish to use a different range, you can specify it when opening the position.

Function Name
Input Parameters
Examples

Supply Liquidity

You have two options to define the input amount: 1. You define the input amounts of both tokens. The excess will be returned to your wallet. TOKEN_A_IN_SYMBOL TOKEN_A_IN_AMOUNT TOKEN_B_IN_SYMBOL TOKEN_B_IN_AMOUNT 2. You can define the input amount as a single token. Helvs will swap it into the desired tokens and will add liquidity with them. This token can also be one of the desired token to supply. TOKEN_A_SYMBOL TOKEN_B_SYMBOL TOKEN_C_SYMBOL TOKEN_C_AMOUNT Optional Parameter of Liquidity Range: - Full Range - Safe (-20%,+40%) - Common (-10%,+20%-Standard) - Expert (-5%, +10%)

  1. Deposit 5 USDC and 5 USDT into USDC/USDT LP

  2. Deposit 10 POL into POL/USDC Pool

  3. Supply all of my AUSD into QUICK/USDT LP with expert price range.

Withdraw Liquidity

TOKEN_A_SYMBOL TOKEN_B_SYMBOL TOKENS_AMOUNT

  1. Withdraw all my LPs from USDC/USDT LP

  2. Withdraw half of my POL/USDC Position

Fetch LP Positions

N/A

Fetch my active LPs Positions

Fetch Pool Data

TOKEN_A_SYMBOL TOKEN_B_SYMBOL

What's the current APR of USDC/USDT LP?

Harvest Accrued Fees

LP_PAIR

Harvest the accrued fees from USDC/USDT LP

Perpetuals 🟢

Helva leverages the Perpetuals service offered by Falkor and Quickswap, which allows fast and anonymous access to leveraged trades. Users can trade more than 40 popular cryptocurrencies with leverage up to x100 and enjoy many advanced features (Orderbook, SL/TP, various order types, etc.).

To start using perps on Helva, you will need to create an account on Quickswap Falkor and deposit USDC into your new account. These operations can be carried out directly through Helva.

Function Name
Input Parameters
Examples

Account Creation

N/A

Can you create my Perps Account?

Deposit

USDC_AMOUNT

Can you deposit 100 USDC in my Perps Account?

Withdrawal

USDC_AMOUNT

Can you withdraw 100 USDC from my Perps Account?

Balance check

N/A

Can you check my perps balance?

Set MAX Leverage

MAX_LEVERAGE

Can you set 50x as max leverage ?

Open Order

CRYPTO_TO_TRADE DIRECTION TRADE_SIZE Please note, trade size parameter follows this formula: trade_size = margin x leverage While the margin is your Perps Balance, user can define trade size by defining: 1. Leverage 2. Base Qty (e.g. 0.02 ETH) 3. USDC Notional ( ORDER Type (Optional Parameter) 1. Market Order 2. Limit Order 3. Stop-Limit Order 4. Stop-Market Order

Market Order Examples: 1. Can you go long with 0.1 BTC? 2. Can you go short on POL with x10 leverage? 3. Go long on QUICK with 100 USDC. Limit Order: 1. Go Short with 0.03 ETH, limit 4,250 Stop Limit Order: 1.If ETH falls to 4,200, go Long with 120 USDC, limit 4,205 Stop Market Order: 1.If ETH drops to 4,150, go Short with 100 USDC

TP/SL Setup

TP_PRICE SL_PRICE

Set a TP of 4,200$ and SL of 3,900$ on my ETH long position.

Fetch Open Orders

N/A

Can you show my perps open orders?

Fetch Active Positions

N/A

Can you show my perps active positions?

Cancel Order

CRYPTO_TO_TRADE

Cancel my order on BTC

Close Position

CRYPTO_TO_TRADE

Close my long position on ETH

Analyses 🟢

Command Name
Input Parameters
Examples

Retreive Historical 30d Daily TXS

TOKEN_NAME

Can you retreive latest data on POL dailyTransactions?

Retreive Historical 30d TVL

TOKEN_NAME

Can you retreive latest data on Ethereum Network TVL?

Retreive Historical 30d Price

TOKEN_NAME

Can you retreive daily historical price of BTC?

Retreive News

TOKEN_NAME

Can you tell me the latest news on Pol and tell me if they are bullish or bearish?

Retreive Technical Indicators

TOKEN_NAME TIMEFRAME ( 1m, 1H, 1d, 7d, 1 Month) Optionally: INDICATOR_TO_RETREIVE DATETIME Please note. Currently the following indicators can be retreived: -Close Price -Moving Averages: SMA, EMA, MAC -Volatility Indicators: Bollingher Bands, Average True Range, Std Deviation -Momentum & Volume Indicators: OBV, ROC, Volume RSI, ADX -Oscillators: RSI, Stochastic Oscillator

  1. Analyze all available technical indicators on POL with hourly timeframe?

  2. What is the trend of BTC Close Price compared to the Moving Averages on daily interval?

  3. Can you show me ETH RSI?

Lending & Borrowing - Aave 🟡

Staking 🟡

Lending & Borrowing - Morpho 🟠

Lending & Borrowing - Compound🟠

Betting - Polymarket🟠

RWA Integration🟠

Advanced Prompts 🟡

Command Name
Example
Inputs

DeFi Functions Combination

  1. Supply all of my USDC, Borrow Maximum POL, stake all of them, Supply back all of my xMATIC

  2. Unstake all my xMATIC, swap all these POL for USDC and execute a yield strategy only for Stablecoins

  3. Swap all of my USDC for WETH and send them to 0x0..0

  4. Swap all of my POL for USDC and add Liquidity to AUD/USDC Pool with all of them

Every Token Imported [See here for the full list]

Perps Trades Analysis+Execution

  1. Analyze with your technical indicators POL Token and go long or short according to the outcome. Use a leverage according to the strenght of your signal.

Every Token Imported [See here for the full list]

Yield Strategy

  1. Use 5 USDC to maximize yields using only stablecoins.

Stablecoins, POL, WETH, WBTC

Last updated