Trade Sense - Eska Platform Documentation

Overview

Trade Sense is a sophisticated educational game that combines AI-generated questions with gamification to help users improve their trading knowledge and skills. It features real-time question generation, comprehensive scoring, and detailed explanations.

AI-Generated Questions

Advanced AI creates unique, challenging trading questions in real-time

Time-Limited Challenges

60-second time limit to answer as many questions as possible

Point Rewards

Earn points for each correct answer to boost your account balance

Performance Analytics

Track your accuracy, speed, and improvement over time

How It Works

1

Start Game Session

Click the Trade Sense widget on the dashboard to begin a new game session

2

AI Question Generation

System generates 20 unique trading questions using advanced AI algorithms

3

Time-Limited Challenge

Answer as many questions as possible within the 60-second time limit

4

Real-Time Feedback

Get immediate feedback on each answer with detailed explanations

5

Results & Rewards

View your performance stats and receive points for correct answers

Game Flow

The Trade Sense game follows a structured flow with multiple states and interactions:

Lobby

Welcome screen with game rules and start button

Loading

AI generates questions and prepares the game session

Playing

Active gameplay with timer, questions, and real-time feedback

Results

Performance summary, points awarded, and play again option

AI-Powered Features

Trade Sense leverages advanced AI technology to create a unique and challenging educational experience:

Dynamic Question Generation

AI creates unique questions covering 25+ trading topics

Educational Explanations

Detailed explanations for each answer to enhance learning

Difficulty Adaptation

Questions range from intermediate to expert level complexity

Content Variety

25 different trading topics with multiple question types

Trading Topics Covered

Position Sizing & Risk Management - Portfolio allocation and risk control
Options Strategies & Greeks - Advanced options trading concepts
Forex Trading & Currency Pairs - Foreign exchange market dynamics
Cryptocurrency Market Analysis - Digital asset trading strategies
Technical Analysis & Chart Patterns - Price action and pattern recognition
Portfolio Hedging Strategies - Risk mitigation techniques
Market Volatility & VIX Trading - Volatility-based strategies
Algorithmic Trading Systems - Automated trading approaches
Derivatives Pricing Models - Mathematical pricing frameworks
Market Microstructure - Order flow and execution dynamics

Daily Limits & Restrictions

Trade Sense implements daily limits to ensure fair play and prevent abuse:

Daily Session Limits

10

Max Sessions/Day

60s

Time Limit/Session

20

Questions Generated

10

Points/Correct Answer

Limit Enforcement

Session Tracking - System tracks daily sessions per user
Real-time Validation - Limits checked before each game start
Graceful Handling - Clear messaging when limits are reached
Daily Reset - Limits reset at midnight each day

Technical Implementation

Frontend Components

`EskaTradeSense.vue`

Main game page with full-screen gameplay experience

`EskaTradeSenseWidget.vue`

Dashboard widget with daily stats and quick access

`EskaTradeSenseModal.vue`

Modal version for embedded gameplay

Backend Architecture

`GameController.php`

API endpoints for question generation and session logging

`GeminiApiService.php`

AI service for generating unique trading questions

`EskaTradeSenseSession.php`

Database model for storing game session results

AI Integration

Gemini API - Google's advanced AI for question generation
Dynamic Prompts - Contextual prompts for varied question types
Quality Validation - Ensures generated questions meet standards
Error Handling - Graceful fallbacks for AI failures

API Endpoints

POST /api/game/generate-questions

Generate AI-powered trading questions for a game session

Request Body:

{
  "count": 20
}

Response:

{
  "success": true,
  "questions": [
    {
      "question": "Advanced trading scenario...",
      "options": ["Option A", "Option B", "Option C"],
      "correctAnswer": 0,
      "explanation": "Detailed explanation..."
    }
  ]
}

POST /api/game/log-session

Log game session results and award points

Request Body:

{
  "total_questions": 15,
  "correct_answers": 12,
  "total_points": 120,
  "accuracy": 80,
  "duration": 60
}

Response:

{
  "success": true,
  "message": "Game session logged successfully",
  "points_awarded": 120
}

GET /api/game/daily-stats

Get user's daily game statistics and remaining sessions

Response:

{
  "success": true,
  "dailyStats": {
    "playedToday": 3,
    "remainingToday": 7,
    "maxDailySessions": 10,
    "canPlay": true
  }
}

Data Structure

Game Session Model

{
  "user_id": 123,
  "total_questions": 15,
  "correct_answers": 12,
  "total_points": 120,
  "accuracy": 80,
  "duration": 60,
  "points_awarded": 120,
  "created_at": "2024-01-01T12:00:00Z",
  "updated_at": "2024-01-01T12:00:00Z"
}

AI-Generated Question

{
  "question": "In a volatile market with VIX at 35, you're managing a $1M portfolio with 60% equity exposure. If you want to hedge 50% of your equity risk using SPY puts with a delta of -0.3, how many contracts should you purchase?",
  "options": [
    "1,000 contracts",
    "2,000 contracts", 
    "3,000 contracts"
  ],
  "correctAnswer": 1,
  "explanation": "To hedge 50% of $600k equity exposure ($300k), with puts having -0.3 delta, you need 2,000 contracts to achieve the desired hedge ratio."
}

Game Configuration

{
  "pointsPerQuestion": 10,
  "timeLimit": 60,
  "enabled": true,
  "maxDailySessions": 10
}

User Experience

Visual Design

Gradient Backgrounds - Eska brand colors with smooth transitions
Card-Based Layout - Clean, modern interface with glass morphism effects
Responsive Design - Optimized for desktop and mobile devices
Dark Theme - Consistent with platform design language

Interactive Elements

Real-Time Timer - Countdown display with visual urgency
Answer Feedback - Immediate visual feedback for correct/incorrect answers
Progress Tracking - Live points and question counter
Smooth Animations - Transitions between game states

Audio Integration

Sound Effects - Audio feedback for correct/incorrect answers
Timer Alerts - Audio cues for final 10 seconds
Game Completion - Celebration sounds for session end
Accessibility - Optional audio for enhanced experience

Configuration

Game Settings

Reward Configuration Keys

// Points per correct answer
'eska_trade_sense_points_per_question' => 10

// Time limit per session (seconds)
'eska_trade_sense_time_limit' => 60

// Maximum daily sessions per user
'eska_trade_sense_max_daily_sessions' => 10

// Enable/disable the game
'eska_trade_sense_enabled' => true

AI Configuration

Question Count - Number of questions generated per session (default: 20)
Difficulty Levels - Intermediate, Advanced, Expert
Topic Variety - 25+ trading topics for comprehensive coverage
Uniqueness - AI ensures each question is unique and challenging

Performance Optimization

Question Pre-generation - Questions generated before game starts
Caching - AI responses cached for performance
Error Handling - Graceful fallbacks for AI failures
Rate Limiting - Prevents abuse of AI generation

Integration

Dashboard Integration

Trade Sense is seamlessly integrated into the main dashboard:

Widget Display - Compact widget showing daily stats and quick access
Real-Time Updates - Widget updates after each game session
Status Indicators - Visual indicators for daily limits and availability
Progress Tracking - Shows games played today and remaining sessions

Points System Integration

Automatic Awarding - Points added to user balance immediately
Activity Logging - All game sessions logged in user activity
Transaction Records - Point transactions tracked for transparency
Leaderboard Impact - Game points contribute to overall ranking

Analytics & Tracking

Session Analytics - Detailed performance metrics per session
User Progress - Track improvement over time
Topic Performance - Identify areas for improvement
Engagement Metrics - Monitor user participation and retention

Best Practices

User Engagement

Balanced Difficulty - Mix of easy and challenging questions
Educational Value - Focus on practical trading knowledge
Immediate Feedback - Quick explanations for learning
Progress Tracking - Clear metrics for improvement

Technical Considerations

AI Reliability - Robust error handling for AI failures
Performance - Optimized question generation and caching
Security - Rate limiting and abuse prevention
Scalability - Efficient handling of concurrent users

Educational Design

Real-World Scenarios - Practical trading situations
Progressive Learning - Questions build on previous knowledge
Comprehensive Coverage - Multiple trading domains
Expert-Level Content - Challenging even for professionals