Guide

Omina Bot - Documentation

Complete user guide for Omina Bot, covering all features and how to use them.

Table of Contents

1. Getting Started

2. Main Features

3. Trading Guide

4. Market Browsing

5. Settings & Preferences

6. Tips & Best Practices

Getting Started

Prerequisites

• Telegram Account: You need a Telegram account to use the bot

• Kalshi Account: A Kalshi account is required for trading features

• Licence Code: Contact Omina support to obtain a licence code

• Kalshi API Key: Generate an API key from your Kalshi account settings

First Steps

1. Start the Bot

   • Find @omina_official_bot on Telegram

   • Send /start command

   • You'll see the main menu with available options

2. Enter Licence Code

   • If you have a licence code, click "🔑 Input licence code"

   • Enter your licence code when prompted

   • Your access will be activated immediately

3. Add Kalshi API Key

   • Click "🔐 Add Kalshi API Key" from the main menu

   • Enter your Kalshi API key and secret when prompted

   • Your API key is encrypted and stored securely

   • Once added, trading features will be available

4. Start Using the Bot

   • Browse markets, place orders, view positions

   • All features are now available!

Main Features

Main Menu

The main menu is your central hub for all bot features. You'll see different options based on your access level:

Without Licence:

• 🔑 Input licence code

With Licence (No API Key):

• 🔐 Add Kalshi API Key

• 📊 Market Stats

• 🔍 Browse Markets

• ⚙️ Settings

With Licence and API Key:

• 📝 Place Order

• 📈 My Positions

• 📋 Open Orders

• 📜 Trade History

• 🔔 Market Alerts

• 📊 Market Stats

• 🔍 Browse Markets

• ⚙️ Settings

Account Status

The main menu displays your account status:

• Access Level: Admin, Active, Expired, or None

• Licence Expiry: When your licence expires (if applicable)

• Balance: Your cash balance and portfolio value (if API key is configured)

• Alerts Status: Whether market alerts are enabled

Trading Guide

Placing an Order

1. Start Order Flow

   • Click "📝 Place Order" from the main menu

   • You'll be prompted to search or browse for a market

2. Select a Market

   • Use the search function to find a specific market

   • Or browse trending/latest markets

   • Click on a market to select it

3. Choose Side

   • Select "Yes" if you think the event will happen

   • Select "No" if you think the event won't happen

4. Choose Action

   • Buy: Purchase contracts (going long)

   • Sell: Sell contracts (going short)

5. Choose Order Type

   • Market Order: Executes immediately at current market price

   • Limit Order: Executes only at your specified price or better

6. Enter Details

   • For limit orders, enter your desired price

   • Review the order summary

7. Confirm Order

   • Review all order details carefully

   • Click "Confirm" to place the order

   • You'll receive a confirmation message

Managing Positions

1. View Positions

   • Click "📈 My Positions" from the main menu

   • You'll see all your open positions with:

     • Market name

     • Side (Yes/No)

     • Quantity

     • Average entry price

     • Current price

     • Unrealized PnL

2. Sell a Position

   • Click on a position from the list

   • Choose how much to sell:

     • 25%: Sell one-quarter of the position

     • 50%: Sell half of the position

     • 75%: Sell three-quarters of the position

     • 100%: Sell the entire position

   • Choose order type (Market or Limit)

   • Confirm the sale

Open Orders

1. View Open Orders

   • Click "📋 Open Orders" from the main menu

   • You'll see all pending orders:

     • Market name

     • Side (Yes/No)

     • Action (Buy/Sell)

     • Order type (Market/Limit)

     • Quantity

     • Price (for limit orders)

     • Status

2. Cancel an Order

   • Click on an order from the list

   • Click "Cancel Order"

   • Confirm cancellation

   • The order will be cancelled immediately

Trade History

1. View Trade History

   • Click "📜 Trade History" from the main menu

   • Browse through your past trades

   • See details for each trade:

     • Market name

     • Side (Yes/No)

     • Action (Buy/Sell)

     • Quantity

     • Price

     • Execution time

     • PnL (if applicable)

Market Browsing

Browse Markets

1. Access Browse

   • Click "🔍 Browse Markets" from the main menu

   • Choose how to browse:

     • Trending: Most popular markets right now

     • Latest: Newest markets available

     • Search: Search by keyword

2. Search Markets

   • Enter a keyword or phrase

   • Browse search results

   • Click on a market to view details

3. Filter Markets

   • Use filters to narrow results:

     • Category

     • Status (open, closed, etc.)

     • Other criteria

   • Apply filters and browse filtered results

4. View Market Details

   • Click on any market to see:

     • Market description

     • Current prices (Yes/No)

     • Volume and activity

     • Event information

     • Series details

Market Statistics

1. View Market Stats

   • Click "📊 Market Stats" from the main menu

   • See aggregated statistics:

     • Overall market trends

     • Popular categories

     • Volume metrics

     • Activity summaries

Settings & Preferences

Access Settings

1. Open Settings

   • Click "⚙️ Settings" from the main menu

   • You'll see all available settings

Available Settings

Alerts

• Toggle Alerts: Enable or disable market volume alerts

• When enabled, you'll receive notifications when markets hit volume thresholds

Timezone

• Set Timezone: Choose your preferred timezone

• All dates and times will display in your selected timezone

• Navigate through timezone options and select yours

Auto-Confirm Orders

• Toggle Auto-Confirm: Enable or disable automatic order confirmation

• Enabled: Orders are placed immediately without confirmation step

• Disabled: You'll see a confirmation screen before orders are placed

Debug Mode

• Toggle Debug Mode: Enable or disable debug information

• When enabled, additional technical information is shown

• Useful for troubleshooting issues

API Key Management

• View API Key Info: See when your API key was added

• Delete API Key: Remove your API key (you'll need to re-add it to trade)

• Show User ID: Display your internal user ID (for support purposes)

Admin Settings

If you're an admin, you'll have access to:

• Create Licence Codes: Generate new licence codes for users

• Delete Licence Codes: Remove licence codes

• Admin Menu: Access administrative functions

Tips & Best Practices

Trading Tips

1. Start Small: Begin with small positions to get familiar with the bot

2. Review Orders: Always review order details before confirming

3. Use Limit Orders: Consider limit orders for better price control

4. Monitor Positions: Regularly check your positions and PnL

5. Set Alerts: Enable alerts to stay informed about market activity

Best Practices

1. Keep API Key Secure: Never share your API key with anyone

2. Check Balance: Regularly check your balance and portfolio value

3. Review Trade History: Review your trade history to learn from past trades

4. Use Settings: Customize timezone and preferences for better experience

5. Stay Updated: Check market stats regularly for trends

Common Workflows

Placing Your First Trade:

1. Browse markets → Find interesting market → View details

2. Place Order → Select market → Choose side → Buy → Market order → Confirm

3. Check Open Orders → Verify order status

4. Check Positions → See your new position

Managing a Position:

1. My Positions → Select position → Choose percentage to sell

2. Select Market or Limit order → Confirm

3. Check Trade History → Verify the sale

Exploring Markets:

1. Browse Markets → Trending or Latest

2. Use filters to narrow down

3. View market details

4. Place order if interested

Additional Resources

• Help Center - FAQs and troubleshooting

• Home - Project overview

---

Need help? Check out the Help Center for answers to common questions.