---
title: "Từ điển mã -> nhãn vi/en: tần suất, giai đoạn công bố, cách cộng dồn, loại giá, thước đo, đơn vị, thương mại, chỉ số tự tính, khái niệm, bộ phân loại, trạng thái giá trị"
method: GET
path: "/macro-economic/dictionary"
tags: ["MacroEconomic"]
---

# Từ điển mã -> nhãn vi/en: tần suất, giai đoạn công bố, cách cộng dồn, loại giá, thước đo, đơn vị, thương mại, chỉ số tự tính, khái niệm, bộ phân loại, trạng thái giá trị

`GET /macro-economic/dictionary`

## Request

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

## Response `200`

OK

- FireAntApiModelsMacroEconomicMacroDictionary: Từ điển mã -&gt; nhãn vi/en của các chiều dữ liệu (GET macro-economic/dictionary)
  - `frequencies` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Tần suất kỳ: A | MY | H | Q | M | SM | D (Rank = thứ tự hiển thị)
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `stages` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Giai đoạn công bố: official | adjusted | preliminary | estimate | flash | unspecified (Rank cao = chắc chắn hơn)
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `timeAggregations` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Cách cộng dồn thời gian (period, month, quarter, year, ytd, point_in_time...)
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `priceBases` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Loại giá: current (danh nghĩa) | constant (thực)
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `measures` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Vai trò thước đo (Class: level | index | rate | share)
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `units` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Đơn vị (Symbol, StandardCode, ConversionFactor sang đơn vị chuẩn, DecimalPlaces)
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `tradeFlows` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Dòng thương mại: export | import | balance
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `tradeScopes` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Phạm vi thương mại: total | fdi | domestic | province
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `tradeBases` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Điều kiện giá thương mại: fob | cif
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `derivedMetrics` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Chỉ số kho tự tính: yoy_pct | mom_pct | qoq_pct
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `concepts` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Khái niệm (dân số, lao động...; Group = nhóm khái niệm)
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `itemSchemes` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Bộ phân loại mục
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)
  - `valueStatuses` FireAntApiModelsMacroEconomicMacroCodeLabel[]: Trạng thái giá trị: valid | provisional | missing | suppressed
    - `code` string: Mã
    - `name` string: Nhãn tiếng Việt
    - `nameEn` string: Nhãn tiếng Anh
    - `rank` integer: Thứ tự / hạng (tần suất, giai đoạn công bố)
    - `class` string: Phân loại (thước đo: level | index | rate | share; đơn vị: CURRENCY | QUANTITY | INDEX...)
    - `group` string: Nhóm (khái niệm)
    - `comparisonBase` string: Kỳ so sánh (thước đo, chỉ số tự tính)
    - `isPercent` boolean: Giá trị là phần trăm (thước đo)
    - `symbol` string: Ký hiệu tiếng Việt (đơn vị)
    - `symbolEn` string: Ký hiệu tiếng Anh (đơn vị)
    - `standardCode` string: Mã đơn vị chuẩn (đơn vị)
    - `conversionFactor` number, double: Hệ số đổi sang đơn vị chuẩn (đơn vị)
    - `decimalPlaces` integer: Số chữ số thập phân nên hiển thị (đơn vị)
    - `isHierarchical` boolean: Bộ phân loại có cấp cha - con (bộ phân loại mục)

## Changes

- **2026-10-10** `300cfd8b632c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/macro-economic/dictionary/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)