---
title: "Tổng quan: chỉ số kỳ này và kỳ trước, chuỗi theo ngày, nội dung nổi bật, cảnh báo gần đây và tình hình vận hành dịch vụ"
method: GET
path: "/ir/{symbol}/dashboard"
tags: ["IRAnalytics"]
---

# Tổng quan: chỉ số kỳ này và kỳ trước, chuỗi theo ngày, nội dung nổi bật, cảnh báo gần đây và tình hình vận hành dịch vụ

`GET /ir/{symbol}/dashboard`

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/ir/{symbol}/dashboard`
- Auth: OAuth 2
  - Implicit: `https://accounts.fireant.vn/connect/authorize`
  - Scopes: `user-data-read`
- TypeScript: <https://skmtc.dev/fireant/apis/fireant-restful-api/docs/ir/:symbol/dashboard/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `symbol` string, required

## Query parameters

- `period` string
- `fromDate` string, date-time
- `toDate` string, date-time

## Response `200`

OK

- FireAntApiModelsIRIRDashboard: Tổng quan dashboard của một mã
  - `symbol` string: Mã chứng khoán
  - `companyName` string: Tên công ty
  - `current` FireAntApiModelsIRIRKpi: Chỉ số tổng hợp của một kỳ. Không có chỉ số lượt xem: hệ thống MXH không ghi nhận sự kiện đó.
    - `fromDate` string, date-time: Từ ngày
    - `toDate` string, date-time: Đến ngày
    - `mentions` integer: Tổng lượt nhắc đến mã
    - `postMentions` integer: Bài viết của nhà đầu tư
    - `commentMentions` integer: Bình luận
    - `newsMentions` integer: Tin tức
    - `disclosureMentions` integer: Công bố thông tin
    - `roomMentions` integer: Bài trong nhóm thảo luận
    - `oaMentions` integer: Bài của Official Account
    - `uniqueAuthors` integer: Số tác giả duy nhất
    - `verifiedAuthors` integer: Tác giả đã định danh
    - `expertAuthors` integer: Tác giả là chuyên gia
    - `authorFollowerSum` integer: Tổng số người theo dõi của các tác giả đã nhắc đến mã - độ phủ tiềm năng. ĐÂY KHÔNG PHẢI LƯỢT XEM: là tổng follower, một người có thể được đếm ở nhiều tác giả.
    - `likes` integer: Lượt thích
    - `replies` integer: Lượt trả lời
    - `shares` integer: Lượt chia sẻ
    - `engagementScore` number, double: Điểm tương tác = thích + 2 x trả lời + 3 x chia sẻ
    - `positiveCount` integer: Số nội dung tích cực
    - `neutralCount` integer: Số nội dung trung tính
    - `negativeCount` integer: Số nội dung tiêu cực
    - `unclassifiedCount` integer: Số nội dung chưa phân loại - hiển thị công khai để biết độ phủ
    - `sentimentScore` number, double: Điểm cảm xúc bình quân (-100..100)
    - `negativeRatio` number, double: Tỉ lệ nội dung tiêu cực trên tổng đã phân loại
    - `severityHighCount` integer: Số nội dung mức nghiêm trọng từ 2 trở lên
    - `watchlistUsers` integer: Số người có mã trong danh mục theo dõi
    - `watchlistNet` integer: Biến động ròng người theo dõi trong kỳ
    - `priceAlertUsers` integer: Số người đặt cảnh báo giá cho mã
    - `roomMembers` integer: Số thành viên các nhóm thảo luận gắn mã
    - `symbolRoomCount` integer: Số nhóm thảo luận gắn mã
    - `oaFollowers` integer: Số người theo dõi Official Account
    - `oaFollowersNet` integer: Biến động ròng người theo dõi Official Account
    - `oaPosts` integer: Số bài Official Account đã đăng
    - `oaLikes` integer: Lượt thích trên bài Official Account
    - `oaReplies` integer: Lượt trả lời trên bài Official Account
    - `shareOfVoice` number, double: Tỉ trọng thảo luận trong nhóm đối chuẩn
    - `peerRank` integer: Thứ hạng trong nhóm đối chuẩn
    - `marketRank` integer: Thứ hạng theo số bài trên toàn sàn
    - `latestDate` string, date-time: Ngày cuối cùng có số liệu trong kỳ
  - `previous` FireAntApiModelsIRIRKpi: Chỉ số tổng hợp của một kỳ. Không có chỉ số lượt xem: hệ thống MXH không ghi nhận sự kiện đó.
    - `fromDate` string, date-time: Từ ngày
    - `toDate` string, date-time: Đến ngày
    - `mentions` integer: Tổng lượt nhắc đến mã
    - `postMentions` integer: Bài viết của nhà đầu tư
    - `commentMentions` integer: Bình luận
    - `newsMentions` integer: Tin tức
    - `disclosureMentions` integer: Công bố thông tin
    - `roomMentions` integer: Bài trong nhóm thảo luận
    - `oaMentions` integer: Bài của Official Account
    - `uniqueAuthors` integer: Số tác giả duy nhất
    - `verifiedAuthors` integer: Tác giả đã định danh
    - `expertAuthors` integer: Tác giả là chuyên gia
    - `authorFollowerSum` integer: Tổng số người theo dõi của các tác giả đã nhắc đến mã - độ phủ tiềm năng. ĐÂY KHÔNG PHẢI LƯỢT XEM: là tổng follower, một người có thể được đếm ở nhiều tác giả.
    - `likes` integer: Lượt thích
    - `replies` integer: Lượt trả lời
    - `shares` integer: Lượt chia sẻ
    - `engagementScore` number, double: Điểm tương tác = thích + 2 x trả lời + 3 x chia sẻ
    - `positiveCount` integer: Số nội dung tích cực
    - `neutralCount` integer: Số nội dung trung tính
    - `negativeCount` integer: Số nội dung tiêu cực
    - `unclassifiedCount` integer: Số nội dung chưa phân loại - hiển thị công khai để biết độ phủ
    - `sentimentScore` number, double: Điểm cảm xúc bình quân (-100..100)
    - `negativeRatio` number, double: Tỉ lệ nội dung tiêu cực trên tổng đã phân loại
    - `severityHighCount` integer: Số nội dung mức nghiêm trọng từ 2 trở lên
    - `watchlistUsers` integer: Số người có mã trong danh mục theo dõi
    - `watchlistNet` integer: Biến động ròng người theo dõi trong kỳ
    - `priceAlertUsers` integer: Số người đặt cảnh báo giá cho mã
    - `roomMembers` integer: Số thành viên các nhóm thảo luận gắn mã
    - `symbolRoomCount` integer: Số nhóm thảo luận gắn mã
    - `oaFollowers` integer: Số người theo dõi Official Account
    - `oaFollowersNet` integer: Biến động ròng người theo dõi Official Account
    - `oaPosts` integer: Số bài Official Account đã đăng
    - `oaLikes` integer: Lượt thích trên bài Official Account
    - `oaReplies` integer: Lượt trả lời trên bài Official Account
    - `shareOfVoice` number, double: Tỉ trọng thảo luận trong nhóm đối chuẩn
    - `peerRank` integer: Thứ hạng trong nhóm đối chuẩn
    - `marketRank` integer: Thứ hạng theo số bài trên toàn sàn
    - `latestDate` string, date-time: Ngày cuối cùng có số liệu trong kỳ
  - `series` FireAntApiModelsIRIRMetricPoint[]: Chuỗi số liệu theo ngày
    - `symbol` string: Mã chứng khoán
    - `date` string, date-time: Ngày
    - `mentions` integer: Lượt nhắc đến
    - `postMentions` integer: Bài nhà đầu tư
    - `commentMentions` integer: Bình luận
    - `newsMentions` integer: Tin tức
    - `disclosureMentions` integer: Công bố thông tin
    - `roomMentions` integer: Bài trong nhóm
    - `oaMentions` integer: Bài Official Account
    - `uniqueAuthors` integer: Tác giả duy nhất trong ngày
    - `authorFollowerSum` integer: Tổng follower của tác giả (không phải lượt xem)
    - `likes` integer: Lượt thích
    - `replies` integer: Lượt trả lời
    - `shares` integer: Lượt chia sẻ
    - `engagementScore` number, double: Điểm tương tác
    - `positiveCount` integer: Tích cực
    - `neutralCount` integer: Trung tính
    - `negativeCount` integer: Tiêu cực
    - `unclassifiedCount` integer: Chưa phân loại
    - `sentimentScore` number, double: Điểm cảm xúc
    - `negativeRatio` number, double: Tỉ lệ tiêu cực
    - `severityHighCount` integer: Nội dung nghiêm trọng
    - `watchlistUsers` integer: Người theo dõi trong watchlist
    - `watchlistNet` integer: Biến động ròng người theo dõi
    - `priceAlertUsers` integer: Người đặt cảnh báo giá
    - `roomMembers` integer: Thành viên nhóm gắn mã
    - `oaFollowers` integer: Người theo dõi Official Account
    - `oaFollowersNet` integer: Biến động ròng follower Official Account
    - `oaPosts` integer: Số bài Official Account
    - `shareOfVoice` number, double: Tỉ trọng thảo luận trong nhóm đối chuẩn
    - `peerRank` integer: Thứ hạng trong nhóm đối chuẩn
    - `marketRank` integer: Thứ hạng toàn sàn
  - `topMentions` FireAntApiModelsIRIRMentionItem[]: Nội dung nổi bật: tương tác cao nhất và tiêu cực nặng nhất
    - `mentionId` integer: ID bản ghi
    - `symbol` string: Mã chứng khoán
    - `postId` integer: ID bài viết trên mạng xã hội
    - `parentPostId` integer: Bài gốc (với bình luận)
    - `channel` 1 | 2 | 3 | 4 | 5 | 6: Kênh phát sinh (1 = Post, 2 = Comment, 3 = News, 4 = Disclosure, 5 = RoomPost, 6 = OfficialAccount)
    - `postDate` string, date-time: Thời điểm đăng
    - `authorUserName` string: Tên đăng nhập của tác giả (thường là email) - chỉ dùng nội bộ FireAnt, luôn rỗng trong phản hồi cho doanh nghiệp
    - `authorName` string: Tên hiển thị công khai của tác giả trên mạng xã hội
    - `authorId` string: Mã tài khoản công khai của tác giả (trang https://fireant.vn/thanh-vien/{AuthorId})
    - `authorFollowers` integer: Số người theo dõi tác giả
    - `authorIsVerified` boolean: Tác giả đã định danh
    - `authorIsExpert` boolean: Tác giả là chuyên gia
    - `roomId` integer: Nhóm thảo luận
    - `roomName` string: Tên nhóm khi nội dung đăng trong nhóm
    - `taggedSymbols` string[]: Tất cả mã được gắn trong bài (theo bảng chữ cái). Bài gắn nhiều mã thường là bình luận chung thị trường.
    - `isRemoved` boolean: Bài gốc không còn trên FireAnt (tác giả xoá, bị gỡ hoặc bị ẩn); nội dung là bản lưu lúc thu thập
    - `title` string: Tiêu đề
    - `snippet` string: Trích đoạn nội dung
    - `url` string: Đường dẫn bài viết
    - `sentiment` integer: Điểm cảm xúc (-100..100)
    - `sentimentLabel` 0 | 1 | 2 | 3: Nhãn cảm xúc (0 = Unknown, 1 = Negative, 2 = Neutral, 3 = Positive)
    - `sentimentSource` 0 | 1 | 2 | 3 | 4: Nguồn phân loại (0 = None, 1 = Inherited, 2 = Lexicon, 3 = Ai, 4 = Manual)
    - `sentimentConfidence` integer: Độ tin cậy của phân loại (0..100)
    - `severity` integer: Mức nghiêm trọng (0..3)
    - `topicsJson` string: Chủ đề nhận diện được
    - `matchedKeywords` string: Từ khóa giám sát đã khớp
    - `isFlagged` boolean: Đã được đánh dấu theo dõi
    - `flagReason` string: Lý do đánh dấu
    - `ticketId` integer: Yêu cầu hỗ trợ liên quan
    - `ticketCode` string: Mã yêu cầu hỗ trợ
    - `ticketStatus` 0 | 1 | 2 | 3 | 4 | 5 | 6: Trạng thái yêu cầu hỗ trợ (0 = New, 1 = Triaged, 2 = InProgress, 3 = WaitingCustomer, 4 = Resolved, 5 = Rejected, 6 = Closed)
    - `likes` integer: Lượt thích
    - `replies` integer: Lượt trả lời
    - `shares` integer: Lượt chia sẻ
    - `engagementScore` number, double: Điểm tương tác
    - `topReason` string: Lý do lọt vào danh sách nổi bật
    - `ingestedDate` string, date-time: Thời điểm thu thập
    - `lastSyncedDate` string, date-time: Lần đồng bộ gần nhất
  - `recentAlerts` FireAntApiModelsIRIRAlertEventItem[]: Cảnh báo gần đây
    - `eventId` integer: ID sự kiện
    - `ruleId` integer: ID quy tắc
    - `ruleName` string: Tên quy tắc
    - `metric` string: Chỉ số
    - `companyId` integer: ID công ty
    - `symbol` string: Mã chứng khoán
    - `companyName` string: Tên công ty
    - `triggeredDate` string, date-time: Thời điểm kích hoạt
    - `metricValue` number, double: Giá trị đo được
    - `baselineValue` number, double: Giá trị nền
    - `deviationSigma` number, double: Số lần độ lệch chuẩn
    - `payloadJson` string: Dữ liệu kèm theo
    - `channels` string: Kênh gửi
    - `recipients` string: Người nhận
    - `notifiedCount` integer: Số người đã được thông báo
    - `acknowledgedBy` string: Người xác nhận đã xem
    - `acknowledgedDate` string, date-time: Thời điểm xác nhận
  - `operations` FireAntApiModelsIRIROperationSummary: Tình hình vận hành dịch vụ của công ty
    - `openTickets` integer: Yêu cầu hỗ trợ đang mở
    - `breachedTickets` integer: Yêu cầu quá hạn cam kết
    - `resolvedLast30Days` integer: Đã xử lý trong 30 ngày
    - `liveSurveys` integer: Khảo sát đang chạy
    - `surveyResponses` integer: Tổng phản hồi khảo sát
    - `oaPostsPendingApproval` integer: Bài Official Account chờ duyệt
    - `unansweredQuestions` integer: Câu hỏi nhà đầu tư chưa trả lời
  - `audienceTrackingSince` string, date-time: Ngày bắt đầu ghi nhận các chỉ số về người theo dõi. Trước ngày này không có số liệu vì hệ thống MXH chỉ lưu trạng thái hiện tại, không lưu lịch sử.

## Changes

- **2026-09-25** `a481789cd81c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/ir/:symbol/dashboard/get.md)

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) - [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireant/apis/fireant-restful-api/revisions/c9b3aa855f95?raw)