Back to Eunoia

Eunoia Documentation

Complete guide to using Eunoia for Solana blockchain operations

Table of Contents

1. Limit Orders

What are Limit Orders?

Limit orders allow you to automatically buy or sell tokens when specific market conditions are met. You can set orders based on market cap or price, and Eunoia will execute them automatically.

Example:

"if BONK hits 100k mc please buy 0.1 SOL worth"

How It Works

  1. Create a limit order using natural language
  2. Eunoia monitors market conditions daily (or more frequently on Pro plan)
  3. When conditions are met, the order executes automatically
  4. You receive an instant notification with transaction details

Trigger Types

Market Cap Triggers

Execute when token reaches a specific market cap:

  • "when it hits 50k mc" = 50,000 market cap
  • "once it reaches 1M market cap" = 1,000,000 market cap
  • Values are in thousands (50k = "50", 1M = "1000")

Price Triggers

Execute when token reaches a specific price:

  • "when price hits $0.001"
  • "sell when it reaches 0.99"
  • Price values are in USD

2. Natural Language Commands

Creating Limit Orders

Buy Orders:

"if this coin hits 50k mc please buy""when BONK reaches 100k market cap, buy 0.5 SOL worth""buy 0.1 SOL when DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 hits 200k mc"

Sell Orders:

"once it hits 100k, sell 50%""sell half when price hits 0.001""when WIF reaches 1M market cap, sell all"

Token Identification

You can specify tokens in multiple ways:

  • Token Symbols: "BONK", "WIF", "USDC"
  • Contract Addresses: Full mint address (e.g., "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263")
  • Context: "this coin", "it" (when referring to a previously mentioned token)

Amount Types

Fixed Amount: Specify exact amount"buy 0.1 SOL worth"
Percentage: Sell a percentage of holdings"sell 50%" or "sell half"
All: Sell entire balance"sell all"

3. Features

✨ Natural Language

Use plain English to create orders. No complex commands or syntax needed.

📊 Market Cap & Price

Set triggers based on market cap (in thousands) or token price (in USD).

🔄 Auto Execution

Orders execute automatically when conditions are met. No manual intervention needed.

📱 Instant Alerts

Receive Telegram notifications when orders execute with transaction links.

💯 Percentage Orders

Sell percentages of your holdings (e.g., "sell 50%", "sell half", "sell all").

🔗 Contract Support

Use token symbols or contract addresses directly. Works with any Solana token.

4. Notifications

Telegram Alerts

When a limit order executes, you'll receive an instant notification via Telegram with:

  • Order type (BUY/SELL) and amount
  • Token information
  • Trigger that was met
  • Transaction hash
  • Direct links to Solscan and Explorer

✅ Success notifications include transaction links for easy verification

❌ Failure notifications include error details to help you fix the issue

5. API Reference

Create Limit Order

POST/api/limit-orders/create
{
  "walletAddress": "user_wallet",
  "tokenAddress": "token_mint_or_symbol",
  "orderType": "buy" | "sell",
  "triggerType": "market_cap" | "price",
  "triggerValue": "50",
  "amount": "0.1" | "50" | "all",
  "amountType": "fixed" | "percentage"
}

List Orders

GET/api/limit-orders/list?walletAddress=xxx&status=active

Cancel Order

POST/api/limit-orders/cancel
{
  "orderId": "order_id",
  "walletAddress": "user_wallet"
}

6. Examples

Example 1: Buy on Market Cap

Command:

"if BONK hits 100k mc please buy 0.1 SOL worth"

What happens:

  • Order created: Buy 0.1 SOL worth of BONK
  • Trigger: When BONK market cap reaches 100k
  • Execution: Automatic when condition is met
  • Notification: Sent via Telegram with transaction link

Example 2: Sell Percentage

Command:

"once WIF hits 200k, sell 50%"

What happens:

  • Order created: Sell 50% of WIF holdings
  • Trigger: When WIF market cap reaches 200k
  • Execution: Calculates 50% of current balance and sells
  • Notification: Sent when order executes

Example 3: Price-Based Order

Command:

"sell all when price hits 0.001"

What happens:

  • Order created: Sell 100% of token holdings
  • Trigger: When token price reaches $0.001
  • Execution: Sells entire balance when price target is met
  • Notification: Sent with transaction details

Need help? Check out our GitHub repository

Back to Eunoia