مرجع جامع زبان GMO Strategy

مقدمه

زبان GMO Strategy یک زبان دامنه‌محور (DSL) است که به‌طور اختصاصی برای سیستم تصمیم‌یار هوشمند خرید و فروش طلا طراحی شده است. این زبان به شما اجازه می‌دهد بدون نوشتن کد پیچیده، استراتژی معاملاتی خود را به زبان ساده بیان کنید.

چرا استراتژی مهم است؟

سیگنال به‌تنهایی فقط یک هشدار است. اگر استراتژی نداشته باشید، در لحظه‌ی دریافت سیگنال دچار تردید یا تصمیم احساسی می‌شوید. با نوشتن استراتژی:

• تصمیم‌های احساسی حذف می‌شوند
• واکنش شما به سیگنال‌ها سریع و یکنواخت می‌شود
• می‌توانید استراتژی خود را در شبیه‌ساز تست کنید
• با گذشت زمان، استراتژی خود را بهینه‌سازی می‌کنید

انواع سیگنال در GMO

سیستم GoldAI چهار نوع سیگنال تولید می‌کند که هر کدام رنگ مخصوص به خود را دارند:

ساختار کلی استراتژی

هر استراتژی در GMO از چهار بخش اصلی تشکیل شده است. این ساختار به شما کمک می‌کند استراتژی خود را منظم و خوانا بنویسید.

قالب پایه

STRATEGY MyStrategy
VERSION 1.0
DESCRIPTION: توضیح اختیاری استراتژی

PARAMETERS:
  SIGNAL     = FIELD(0)
  CONFIDENCE = FIELD(1)
  PRICE      = FIELD(5)

RULES:
  SIGNAL = GREEN -> BUY(1G)
  SIGNAL = RED   -> SELL(1G)
END

بخش PARAMETERS

در این بخش، متغیرهایی تعریف می‌کنید که در قوانین استفاده خواهند شد. هر متغیر یک نام (با حروف بزرگ) و یک مقدار دارد. مقدار می‌تواند از توابع FIELD() یا یک عدد ثابت باشد.

بخش RULES

در این بخش، قوانین استراتژی خود را می‌نویسید. هر قانون از سه بخش تشکیل شده است:

SIGNAL = GREEN -> BUY(1G) IF CONFIDENCE > 70
          ↑        ↑   ↑              ↑
        شروط         مقدار  عمل    سیگنال

1. سیگنال ورودی نوع سیگنال را مشخص می‌کند: GREEN، RED، BLUE یا YELLOW
2. عمل (Action) تابعی که اجرا می‌شود: BUY(...) یا SELL(...)
3. شرط (اختیاری) با کلمه‌ی کلیدی IF می‌توانید شرط اضافه کنید. اگر شرط برقرار نباشد، قانون اجرا نمی‌شود.

مرجع توابع

زبان GMO Strategy از سه دسته تابع پشتیبانی می‌کند: توابع دسترسی به داده، توابع اقدام (خرید/فروش)، و توابع آماری روی تاریخچه سیگنال‌ها.

PARAMETERS:
  SIGNAL     = FIELD(0)  // نام سیگنال
  CONFIDENCE = FIELD(1)  // درصد اعتماد
  PRICE      = FIELD(5)  // قیمت
  GmoML      = FIELD(6)  // پیشنهاد GmoML
  MARKET     = FIELD(7)  // وضعیت بازار

// خرید ۱ گرم در منبع CASH
SIGNAL = GREEN -> BUY(1G)

// خرید نیم گرم در منبع CASH
SIGNAL = BLUE -> BUY(0.5G)

// خرید پیش‌فرض ۱ گرم در منبع CASH
SIGNAL = GREEN -> BUY()

// خرید ۱ گرم در منبع GREEN
SIGNAL = GREEN -> BUY(GREEN:1G)

// خرید نیم گرم در منبع BLUE
SIGNAL = BLUE -> BUY(BLUE:0.5G)

// خرید در منبع دلخواه LONGTERM
SIGNAL = GREEN -> BUY(LONGTERM:2G)

// خرید نیم‌گرم آبی + نیم‌گرم سبز در یک سیگنال سبز
SIGNAL = GREEN -> BUY(BLUE:0.5G, GREEN:0.5G)

// فروش ۱ گرم از منبع CASH
SIGNAL = RED -> SELL(1G)

// فروش نیم گرم از منبع CASH
SIGNAL = YELLOW -> SELL(0.5G)

// فروش ۱ گرم از منبع BLUE
SIGNAL = RED -> SELL(BLUE:1G)

// فروش ۱ گرم از منبع GREEN
SIGNAL = YELLOW -> SELL(GREEN:1G)

// فروش ۲ گرم از منبع LONGTERM
SIGNAL = RED -> SELL(LONGTERM:2G)

// فروش نیم‌گرم آبی + ۱ گرم سبز در یک سیگنال قرمز
SIGNAL = RED -> SELL(BLUE:0.5G, GREEN:1G)

// فقط وقتی سیگنال سبز را معامله کن که اعتمادش
// از آخرین سیگنال سبز بیشتر باشد
SIGNAL = GREEN -> BUY(1G) IF CONFIDENCE > LAST_CONFIDENCE(GREEN)

// فروش اگر قیمت فعلی از آخرین قیمت آبی بیشتر باشد
SIGNAL = YELLOW -> SELL(0.5G) IF PRICE > LAST_PRICE(BLUE)

// فقط وقتی سبز را معامله کن که اعتمادش
// از کمترین اعتماد ۵ سبز آخر بیشتر باشد
SIGNAL = GREEN -> BUY(1G) IF CONFIDENCE > MIN_CONFIDENCE(GREEN, 5)

// فقط وقتی قیمت زیر کمترین قیمت ۱۰ آبی آخر است، بخر
SIGNAL = BLUE -> BUY(1G) IF PRICE < MIN_PRICE(BLUE, 10)

// فروش وقتی قیمت از بیشترین قیمت ۱۰ سبز آخر بیشتر شد
SIGNAL = RED -> SELL(1G) IF PRICE > MAX_PRICE(GREEN, 10)

// خرید اگر قیمت فعلی زیر میانگین قیمت ۲۰ آبی آخر باشد
SIGNAL = BLUE -> BUY(1G) IF PRICE < AVG_PRICE(BLUE, 20)

// خرید اگر اعتماد فعلی از میانگین اعتماد ۵ سبز آخر بیشتر باشد
SIGNAL = GREEN -> BUY(1G) IF CONFIDENCE > AVG_CONFIDENCE(GREEN, 5)

مثال‌های کامل استراتژی

در این بخش، چند استراتژی کامل و کاربردی را با هم بررسی می‌کنیم. هر مثال را می‌توانید مستقیماً در پنل GMO کپی و استفاده کنید.

۱) استراتژی محافظه‌کارانه

ساده‌ترین استراتژی ممکن که فقط روی سیگنال‌های قوی (سبز و قرمز) معامله می‌کند و سیگنال‌های ضعیف را نادیده می‌گیرد.

STRATEGY Conservative
VERSION 1.0
DESCRIPTION: فقط سیگنال‌های قوی را معامله کن

PARAMETERS:
  SIGNAL = FIELD(0)

RULES:
  SIGNAL = GREEN -> BUY(1G)
  SIGNAL = RED   -> SELL(1G)
END

۲) استراتژی صعودی اعتماد

فقط زمانی معامله می‌کند که درصد اعتماد سیگنال فعلی، از آخرین سیگنال هم‌نام بالاتر باشد.

STRATEGY UpwardConfidence
VERSION 1.0

PARAMETERS:
  SIGNAL     = FIELD(0)
  CONFIDENCE = FIELD(1)

RULES:
  SIGNAL = GREEN  -> BUY(1G)  IF CONFIDENCE > LAST_CONFIDENCE(GREEN)
  SIGNAL = BLUE   -> BUY(0.5G) IF CONFIDENCE > LAST_CONFIDENCE(BLUE)
  SIGNAL = YELLOW -> SELL(0.5G) IF CONFIDENCE > LAST_CONFIDENCE(YELLOW)
  SIGNAL = RED    -> SELL(1G)  IF CONFIDENCE > LAST_CONFIDENCE(RED)
END

۳) استراتژی بلندمدت پله‌ای

با سیگنال سبز، یک گرم می‌خرد؛ با سیگنال آبی، نیم‌گرم. هنگام فروش، ابتدا از منبع آبی خارج می‌شود و سپس از منبع سبز.

STRATEGY LongTerm
VERSION 1.0

PARAMETERS:
  SIGNAL = FIELD(0)

RULES:
  SIGNAL = GREEN  -> BUY(1G)
  SIGNAL = BLUE   -> BUY(0.5G)
  SIGNAL = YELLOW -> SELL(BLUE:0.5G)
  SIGNAL = RED    -> SELL(BLUE:0.5G, GREEN:1G)
END

۴) استراتژی فروش سودده

فقط زمانی می‌فروشد که قیمت حداقل ۱۲٪ بالاتر از قیمت خرید باشد. یعنی هرگز با ضرر از بازار خارج نمی‌شود.

STRATEGY ProfitableSale
VERSION 1.0

PARAMETERS:
  SIGNAL = FIELD(0)
  PRICE  = FIELD(5)

RULES:
  SIGNAL = GREEN  -> BUY(1G)
  SIGNAL = BLUE   -> BUY(0.5G)
  SIGNAL = YELLOW -> SELL(BLUE:0.5G) IF PRICE > LAST_PRICE(BLUE) + ((LAST_PRICE(BLUE) * 12) / 100)
  SIGNAL = RED    -> SELL(GREEN:1G) IF PRICE > LAST_PRICE(GREEN) + ((LAST_PRICE(GREEN) * 12) / 100)
END

۵) استراتژی ترکیبی پیشرفته

ترکیبی از چند شرط: بررسی اعتماد، بررسی قیمت، و مدیریت پوزیشن.

STRATEGY Advanced
VERSION 2.0
DESCRIPTION: استراتژی چند شرطی

PARAMETERS:
  SIGNAL     = FIELD(0)
  CONFIDENCE = FIELD(1)
  PRICE      = FIELD(5)

RULES:
  // سیگنال سبز قوی: خرید ۱ گرم
  SIGNAL = GREEN -> BUY(1G) IF CONFIDENCE > AVG_CONFIDENCE(GREEN, 5)

  // سیگنال قرمز: فروش فقط اگر قیمت ۱۰٪ بالاتر باشد
  SIGNAL = RED -> SELL(GREEN:1G) IF PRICE > LAST_PRICE(GREEN) * 1.1

  // سیگنال آبی: خرید نیم‌گرم
  SIGNAL = BLUE -> BUY(0.5G)

  // سیگنال زرد: فروش نیم‌گرم از آبی
  SIGNAL = YELLOW -> SELL(BLUE:0.5G)
END

۶) استراتژی ترکیبی GMO + GmoML

در این استراتژی، سیگنال GMO با پیشنهاد GmoML ترکیب می‌شود. فقط زمانی معامله می‌کنیم که هر دو منبع با هم هم‌راستا باشند.

STRATEGY HybridGMO
VERSION 1.1
DESCRIPTION: ترکیب سیگنال GMO با پیشنهاد GmoML

PARAMETERS:
  SIGNAL     = FIELD(0)
  CONFIDENCE = FIELD(1)
  PRICE      = FIELD(5)
  GmoML      = FIELD(6)

RULES:
  SIGNAL = GREEN  -> BUY(1G)   IF GmoML = 1 AND CONFIDENCE > 70
  SIGNAL = BLUE   -> BUY(0.5G) IF GmoML = 1 OR GmoML = 3
  SIGNAL = RED    -> SELL(1G)  IF GmoML = 2
  SIGNAL = YELLOW -> SELL(0.5G) IF GmoML = 2 OR GmoML = 4
END

۷) استراتژی هم‌راستا با وضعیت بازار

این استراتژی فقط زمانی خرید می‌کند که بازار صعودی یا خنثی باشد و فقط زمانی فروش می‌کند که بازار نزولی یا خنثی باشد. به این ترتیب از معامله در خلاف جهت روند بازار جلوگیری می‌شود.

STRATEGY MarketAware
VERSION 1.0
DESCRIPTION: معامله فقط در جهت روند بازار

PARAMETERS:
  SIGNAL     = FIELD(0)
  CONFIDENCE = FIELD(1)
  MARKET     = FIELD(7)

RULES:
  // خرید فقط در بازار صعودی یا خنثی
  SIGNAL = GREEN -> BUY(1G) IF MARKET = 1 OR MARKET = 0
  SIGNAL = BLUE  -> BUY(0.5G) IF MARKET = 1

  // فروش فقط در بازار نزولی یا خنثی
  SIGNAL = RED    -> SELL(1G) IF MARKET = 2 OR MARKET = 0
  SIGNAL = YELLOW -> SELL(0.5G) IF MARKET = 2
END

مرجع سریع توابع

جدول زیر خلاصه‌ای کامل از تمام توابع قابل استفاده در GMO Strategy Language است، همراه با تمام حالت‌های ممکن و مقدار پیش‌فرض.

📥 توابع دسترسی به داده

🛒 توابع خرید (BUY)

💵 توابع فروش (SELL)

📊 توابع آماری — اعتماد (CONFIDENCE)

💰 توابع آماری — قیمت (PRICE)

🎯 مقادیر مجاز source

🎯 مقادیر GmoML

🎯 مقادیر وضعیت بازار (MARKET)

🔧 عملگرهای منطقی و مقایسه‌ای

📏 واحدهای مقدار (value)

🏷️ کلیدواژه‌های ساختاری

خطاهای رایج

در این بخش، خطاهای رایجی که ممکن است هنگام نوشتن استراتژی با آن‌ها مواجه شوید، بررسی می‌کنیم.

STRATEGY Test
VERSION 1.0
PARAMETERS:
  SIGNAL = FIELD(0)
RULES:
  SIGNAL = GREEN -> BUY(1G)
// END فراموش شده!