--- title: "Dựng gói trang từ nội dung chưa lưu để xem trước như nhà đầu tư thấy" method: POST path: "/ir/{symbol}/page/preview" tags: ["IRPage"] --- # Dựng gói trang từ nội dung chưa lưu để xem trước như nhà đầu tư thấy `POST /ir/{symbol}/page/preview` ## Request - Base URL: `https://api.fireant.vn` - URL: `https://api.fireant.vn/ir/{symbol}/page/preview` - Auth: OAuth 2 - Implicit: `https://accounts.fireant.vn/connect/authorize` - Scopes: `user-data-read` - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `symbol` string, required ## Request body - FireAntApiModelsIRIRPagePreviewRequest: Xem trước: dựng gói trang từ nội dung chưa lưu - `content` object - `lang` string ## Response `200` OK - FireAntApiModelsIRIRPageBundle - `symbol` string - `locale` string - `status` string: published | auto | preview - `official` boolean: Trang do doanh nghiệp quản lý; trang tự động thì false - `verified` boolean: Official Account đã xác minh - `company` FireAntApiModelsIRIRBundleCompany - `name` string - `shortName` string - `exchange` string - `industry` string - `logo` string - `website` string - `oaUserId` string: Trang công khai của Official Account: fireant.vn/thanh-vien/{oaUserId} - `oaName` string - `page` object: Tài liệu trang (JSON ir-page) - `media` object: media:<id> → URL - `data` FireAntApiModelsIRIRPageData - `quote` FireAntApiModelsIRIRQuoteSnapshot - `price` number, double - `refPrice` number, double - `change` number, double - `changePct` number, double - `open` number, double - `high` number, double - `low` number, double - `volume` number, double - `value` number, double - `marketCap` number, double - `sharesOutstanding` number, double - `freeShares` number, double - `high52w` number, double - `low52w` number, double - `change1y` number, double - `foreignRoom` number, double - `foreignOwnership` number, double - `beta` number, double - `avgVolume10d` number, double - `asOf` string - `facts` FireAntApiModelsIRIRKeyFacts - `companyName` string - `shortName` string - `internationalName` string - `exchange` string - `icbCode` string - `industry` string - `companyType` string: General | Bank | Securities | Insurance - `charterCapital` number, double - `sharesOutstanding` number, double - `listingDate` string - `establishmentDate` string - `headquarters` string - `phone` string - `email` string - `website` string - `employees` integer - `branches` integer - `taxCode` string - `overview` string - `businessAreas` string - `isListed` boolean - `financials` FireAntApiModelsIRIRFinancialsData - `companyType` string - `quarterly` FireAntApiModelsIRIRFinancialSeries - `period` string: Q | Y - `periods` string[]: "Q1/2025" hoặc "2025", cũ trước mới sau - `values` object - `sector` object - `annual` FireAntApiModelsIRIRFinancialSeries - `period` string: Q | Y - `periods` string[]: "Q1/2025" hoặc "2025", cũ trước mới sau - `values` object - `sector` object - `ttm` object - `latestPeriod` string - `ratios` FireAntApiModelsIRIRRatioItem[] - `key` string - `value` number, double - `industry` number, double - `dividends` FireAntApiModelsIRIRDividendYear[] - `year` integer - `cash` number, double: Đồng / cổ phiếu - `stock` number, double: Tỉ lệ (0,2 = 20%) - `corporateEvents` FireAntApiModelsIRIRCorporateEvent[] - `id` integer - `kind` string: cash_dividend | stock_dividend | rights | other - `title` string - `exDate` string: Ngày giao dịch không hưởng quyền - `recordDate` string: Ngày đăng ký cuối cùng - `payDate` string: Ngày thực hiện / thanh toán - `prices` FireAntApiModelsIRIRPricesData - `daily` FireAntApiModelsIRIRPricePoint[] - `d` string - `c` number, double - `v` number, double - `weekly` FireAntApiModelsIRIRPricePoint[] - `d` string - `c` number, double - `v` number, double - `holders` FireAntApiModelsIRIRHolderItem[] - `name` string - `position` string - `shares` number, double - `ownership` number, double: Tỉ lệ (0–1) - `isOrganization` boolean - `isForeigner` boolean - `reported` string - `ownership` FireAntApiModelsIRIROwnership - `state` number, double - `foreign` number, double - `other` number, double - `freeFloat` number, double - `foreignLimit` number, double - `asOf` string - `officers` FireAntApiModelsIRIROfficerItem[] - `name` string - `position` string - `group` string: board | executive | supervisory | other - `isForeigner` boolean - `individualId` integer - `photoUrl` string - `insiderTrades` FireAntApiModelsIRIRInsiderTrade[] - `name` string - `position` string - `kind` string: buy | sell | other - `registered` number, double - `executed` number, double - `startDate` string - `endDate` string - `executionDate` string - `disclosures` FireAntApiModelsIRIRNewsItem[] - `id` integer - `title` string - `summary` string - `date` string - `url` string - `source` string - `kind` string: disclosure | news | oa - `image` string - `news` FireAntApiModelsIRIRNewsItem[] - `id` integer - `title` string - `summary` string - `date` string - `url` string - `source` string - `kind` string: disclosure | news | oa - `image` string - `oaPosts` FireAntApiModelsIRIRNewsItem[] - `id` integer - `title` string - `summary` string - `date` string - `url` string - `source` string - `kind` string: disclosure | news | oa - `image` string - `documents` FireAntApiModelsIRIRBundleDocument[] - `id` integer - `title` string - `category` integer - `period` string - `language` string - `url` string - `fileName` string - `size` integer - `contentType` string - `publishedDate` string - `downloads` integer - `events` FireAntApiModelsIRIRBundleEvent[] - `id` integer - `type` integer - `title` string - `description` string - `start` string - `end` string - `location` string - `onlineUrl` string - `livestreamPostId` integer - `status` integer - `registrable` boolean - `registrations` integer - `questions` FireAntApiModelsIRIRBundleQuestions - `items` FireAntApiModelsIRIRBundleQuestion[] - `id` integer - `body` string - `askedByName` string: Tên công khai; ẩn danh thì "Nhà đầu tư ẩn danh" - `anonymous` boolean - `askedAt` string - `status` string: pending | answered - `answer` string - `answeredAt` string - `upVotes` integer - `context` string - `total` integer - `answered` integer - `pending` integer - `surveys` FireAntApiModelsIRIRBundleSurvey[] - `companySurveyId` integer - `surveyId` integer - `title` string - `status` integer - `endDate` string - `responses` integer - `livestreams` FireAntApiModelsIRIRLivestreamInfo[] - `postId` integer - `title` string - `userId` string - `started` boolean - `ended` boolean - `scheduledAt` string - `viewUrl` string - `thumbnail` string - `peers` FireAntApiModelsIRIRPeerRow[] - `symbol` string - `name` string - `self` boolean - `values` object - `plan` FireAntApiModelsIRIRPlanItem[] - `metric` string - `year` integer - `target` number, double - `actual` number, double - `ratio` number, double - `source` string: company | fireant - `quarters` number[] - `asOf` string - `sourceDocumentId` integer - `tokens` object: Giá trị số liệu sống (khóa như fin.revenue_ytd) - `features` string[]: qa.ask | qa.vote | follow | events.register | contact | livestream | survey | claim | embed - `version` integer - `publishedAt` string, date-time - `generatedAt` string, date-time - `canonicalUrl` string ## Changes - **2026-10-10** `300cfd8b632c`: 1 info - endpoint added [Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/ir/:symbol/page/preview/post.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)