عمومی/api/v1

تحلیلگر نماد

تحلیل هوشمند یک نماد — عمومی و بدون توکن.

تحلیل هوشمند یک نماد بورسی — شامل نگاه کلی، احساس بازار، نقاط کلیدی و سطح اطمینان مدل.

GET/api/v1/symbols/{id}/ai-recommendation

Auth: None — عمومی

Path:

Param	Type	Description
`id`	string	شناسه نماد، مثلاً `foolad`

Query:

Param	Type	Required	Description
`locale`	`fa` \| `en`	no	زبان خروجی؛ پیش‌فرض `fa`

Response 200: AiRecommendation

نمونه

{
  "title": "خرید در اصلاحات",
  "text": "روند میان‌مدت مثبت است و حجم معاملات از میانگین بالاتر رفته است.",
  "sentiment": "bullish",
  "confidence": 78,
  "points": [
    "حمایت قوی در محدوده ۱,۲۰۰",
    "گزارش عملکرد مثبت فصل اخیر"
  ],
  "generatedAt": "2026-06-15T10:00:00.000Z"
}

Field	Type	Description
`title`	string	عنوان کوتاه تحلیل
`text`	string	جمع‌بندی متنی
`sentiment`	`AiSentiment`	`bullish` \| `bearish` \| `neutral`
`confidence`	number	اطمینان مدل ۰ تا ۱۰۰
`points`	string[]	نکات کلیدی
`generatedAt`	string	زمان تولید (ISO 8601)

Errors:

HTTP	`code`	When
404	`not_found`	نماد وجود ندارد

Example

نمونه

curl -X GET "https://api.codal724.ir/api/v1/symbols/foolad/ai-recommendation?locale=fa" \
  -H "Accept: application/json"