# ดึงตัวชี้วัดทางการเงิน

**API:** Data API

**Endpoint:** `GET /v1/beta/financial/financial-metrics`

**Tags:** Financial Data

อัตราส่วนที่คำนวณได้สำหรับบริษัทหนึ่งเมื่อเวลาผ่านไป ประมาณ 49 รายการต่อช่วง: `market_cap`, `enterprise_value`, `price_to_earnings_ratio`, `price_to_book_ratio`, `price_to_sales_ratio`, `enterprise_value_to_ebitda_ratio`, `free_cash_flow_yield`, `peg_ratio`, `gross_margin`, `operating_margin`, `net_margin`, `return_on_equity`, `return_on_assets`, `return_on_invested_capital`, อัตราส่วนการหมุนเวียนและสภาพคล่อง โดยแต่ละรายการประทับด้วย `report_period` และ `fiscal_period` `period` เป็นฟิลด์บังคับ; ระบุด้วย `ticker` หรือ `cik` ใช้เพื่อดูแนวโน้มของอัตราส่วนข้ามช่วง สำหรับค่าปัจจุบันเท่านั้น `get_financial_financial_metrics_snapshot` เป็นแถวเดียวและเล็กกว่ามาก

### ข้อมูลอ้างอิงราคา

- การวัดปริมาณการใช้งาน: ฐานต้นทุนคำขอที่สำเร็จแบบคงที่
- ค่าประมาณคำขออ้างอิง: USD 0.02
- ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cik` | query | no | string | Central Index Key (CIK) ของบริษัท ใช้แทน ticker ได้ |
| `cursor` | query | no | string | เคอร์เซอร์การแบ่งหน้าแบบทึบจาก next_page_url ของการตอบกลับก่อนหน้า เมื่อระบุ พารามิเตอร์คำขออื่นทั้งหมดจะถูกเพิกเฉย: เคอร์เซอร์นำตัวกรองของคำขอเดิมมาด้วย ถือเป็นค่าทึบ ห้ามสร้างหรือแก้ไข |
| `filing_date` | query | no | string, (date) | กรองตามวันที่ยื่นเอกสาร SEC ที่ตรงกันในรูปแบบ YYYY-MM-DD แถวที่ไม่มีวันที่ยื่นเอกสารจะถูกตัดออก |
| `filing_date_gt` | query | no | string, (date) | กรองตามวันที่ยื่นเอกสาร SEC ที่มากกว่าวันที่ในรูปแบบ YYYY-MM-DD แถวที่ไม่มีวันที่ยื่นเอกสารจะถูกตัดออก |
| `filing_date_gte` | query | no | string, (date) | กรองตามวันที่ยื่นเอกสาร SEC ที่มากกว่าหรือเท่ากับวันที่ในรูปแบบ YYYY-MM-DD แถวที่ไม่มีวันที่ยื่นเอกสารจะถูกตัดออก |
| `filing_date_lt` | query | no | string, (date) | กรองตามวันที่ยื่นเอกสาร SEC ที่น้อยกว่าวันที่ในรูปแบบ YYYY-MM-DD แถวที่ไม่มีวันที่ยื่นเอกสารจะถูกตัดออก |
| `filing_date_lte` | query | no | string, (date) | กรองตามวันที่ยื่นเอกสาร SEC ที่น้อยกว่าหรือเท่ากับวันที่ในรูปแบบ YYYY-MM-DD มีประโยชน์สำหรับคำค้นแบบจุดเวลา: คืนเฉพาะข้อมูลที่ถูกยื่นต่อสาธารณะภายในวันที่ที่ระบุ แถวที่ไม่มีวันที่ยื่นเอกสารจะถูกตัดออก |
| `limit` | query | no | integer | จำนวนผลลัพธ์สูงสุดที่จะคืน นี่คือยอดรวมในทุกหน้า ไม่ใช่ขนาดหน้า: แต่ละหน้ามีไม่เกิน 10 รายการ เชื่อมกันด้วย `next_page_url` |
| `period` | query | yes | string, enum: "annual", "quarterly", "ttm" | ช่วงเวลาของข้อมูลทางการเงิน |
| `report_period` | query | no | string, (date) | กรองตามวันที่ของงบการเงินที่ตรงกันในรูปแบบ YYYY-MM-DD |
| `report_period_gt` | query | no | string, (date) | กรองตามรอบระยะเวลารายงานที่มากกว่าวันที่ในรูปแบบ YYYY-MM-DD |
| `report_period_gte` | query | no | string, (date) | กรองตามรอบระยะเวลารายงานที่มากกว่าหรือเท่ากับวันที่ในรูปแบบ YYYY-MM-DD |
| `report_period_lt` | query | no | string, (date) | กรองตามรอบระยะเวลารายงานที่น้อยกว่าวันที่ในรูปแบบ YYYY-MM-DD |
| `report_period_lte` | query | no | string, (date) | กรองตามรอบระยะเวลารายงานที่น้อยกว่าหรือเท่ากับวันที่ในรูปแบบ YYYY-MM-DD |
| `ticker` | query | no | string | สัญลักษณ์ ticker ของบริษัท จำเป็นหากไม่ได้ระบุ cik |

## Responses

### 200 — ตัวชี้วัดและอัตราส่วนทางการเงินย้อนหลังสำหรับ ticker

Headers:
- `X-Request-Id` (string) — ตัวระบุคำขอที่ต้องระบุเมื่อติดต่อฝ่ายสนับสนุนของ Felo

**application/json**

Schema: `ResponseE40Feb4D3D6B_FinancialMetricsResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_FinancialMetricsResponse`)

### 400 — ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ

### 401 — จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง

### 402 — ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน

### 403 — บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้

### 429 — ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว

### 502 — บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้

### 503 — API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว

### 504 — บริการหมดเวลาระหว่างประมวลผลคำขอ

### default — การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_FinancialMetricsResponse

`#/components/schemas/ResponseE40Feb4D3D6B_FinancialMetricsResponse`

```json
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "สัญลักษณ์ ticker ของบริษัท"
    },
    "report_period": {
      "type": "string",
      "format": "date",
      "description": "รอบระยะเวลารายงานของตัวชี้วัดทางการเงิน"
    },
    "fiscal_period": {
      "type": "string",
      "description": "งวดบัญชีของตัวชี้วัดทางการเงิน"
    },
    "period": {
      "type": "string",
      "enum": [
        "quarterly",
        "ttm",
        "annual"
      ],
      "description": "ช่วงเวลาของตัวชี้วัดทางการเงิน"
    },
    "currency": {
      "type": "string",
      "description": "สกุลเงินที่รายงานข้อมูลทางการเงิน"
    },
    "accession_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "หมายเลข accession ของ SEC สำหรับเอกสารยื่น"
    },
    "form_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "แบบฟอร์ม SEC ที่แถวนี้มาจาก (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...) เป็นแบบฟอร์มที่ยื่นจริง ดังนั้นการแก้ไขจะคงส่วนต่อท้าย `/A` ไว้ เป็น null เมื่อ `period` เป็น `ttm`: หน้าต่างสิบสองเดือนย้อนหลังอาจครอบคลุมหลายเอกสารยื่น จึงไม่ระบุว่าเป็นของฉบับใดฉบับหนึ่ง แถว `quarterly` อาจมี `10-K` เมื่อไตรมาสที่สี่ได้มาจากเอกสารยื่นประจำปีงบประมาณ"
    },
    "filing_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "description": "URL ไปยังเอกสารยื่นต่อ SEC"
    },
    "filing_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "วันที่ตามปฏิทินที่ SEC รับเอกสารยื่น ตามเวลาตะวันออก (เขตเวลาทำการของ SEC) จับคู่กับ `filing_datetime` ในระดับวัน เป็น null เมื่อไม่มีเอกสารยื่นต่อ SEC ที่มีวันที่เชื่อมโยงกับแถวนี้"
    },
    "filing_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "เวลาประทับระดับต่ำกว่าวันที่บันทึกว่า SEC รับเอกสารยื่นเมื่อใด ตามเวลาตะวันออก ดึงจากฟิลด์ `acceptanceDateTime` ใน API submissions ของ EDGAR จับคู่กับ `filing_date` (ความละเอียดระดับวันของเหตุการณ์เดียวกัน)"
    },
    "enterprise_value": {
      "type": "number",
      "description": "มูลค่ารวมของบริษัท (มูลค่าตลาด + หนี้สิน - เงินสด)"
    },
    "price_to_earnings_ratio": {
      "type": "number",
      "description": "อัตราส่วนราคาต่อกำไร"
    },
    "price_to_book_ratio": {
      "type": "number",
      "description": "อัตราส่วนราคาต่อมูลค่าตามบัญชี"
    },
    "price_to_sales_ratio": {
      "type": "number",
      "description": "อัตราส่วนราคาต่อรายได้"
    },
    "enterprise_value_to_ebitda_ratio": {
      "type": "number",
      "description": "อัตราส่วนมูลค่ากิจการต่อ EBITDA"
    },
    "enterprise_value_to_revenue_ratio": {
      "type": "number",
      "description": "อัตราส่วนมูลค่ากิจการต่อรายได้"
    },
    "free_cash_flow_yield": {
      "type": "number",
      "description": "อัตราผลตอบแทนกระแสเงินสดอิสระ"
    },
    "peg_ratio": {
      "type": "number",
      "description": "อัตราส่วนราคาต่อกำไรต่อการเติบโต"
    },
    "gross_margin": {
      "type": "number",
      "description": "กำไรขั้นต้นเป็นเปอร์เซ็นต์ของรายได้"
    },
    "operating_margin": {
      "type": "number",
      "description": "กำไรจากการดำเนินงานเป็นเปอร์เซ็นต์ของรายได้"
    },
    "net_margin": {
      "type": "number",
      "description": "กำไรสุทธิเป็นเปอร์เซ็นต์ของรายได้"
    },
    "return_on_equity": {
      "type": "number",
      "description": "กำไรสุทธิเป็นเปอร์เซ็นต์ของส่วนของผู้ถือหุ้น"
    },
    "return_on_assets": {
      "type": "number",
      "description": "กำไรสุทธิเป็นเปอร์เซ็นต์ของสินทรัพย์รวม"
    },
    "return_on_invested_capital": {
      "type": "number",
      "description": "กำไรจากการดำเนินงานสุทธิหลังภาษีเป็นเปอร์เซ็นต์ของเงินทุนที่ลงทุน"
    },
    "asset_turnover": {
      "type": "number",
      "description": "รายได้หารด้วยสินทรัพย์รวมเฉลี่ย"
    },
    "inventory_turnover": {
      "type": "number",
      "description": "ต้นทุนขายหารด้วยสินค้าคงเหลือเฉลี่ย"
    },
    "receivables_turnover": {
      "type": "number",
      "description": "รายได้หารด้วยลูกหนี้การค้าเฉลี่ย"
    },
    "days_sales_outstanding": {
      "type": "number",
      "description": "ลูกหนี้การค้าเฉลี่ยหารด้วยรายได้ตลอดช่วงเวลา"
    },
    "operating_cycle": {
      "type": "number",
      "description": "อัตราการหมุนเวียนสินค้าคงเหลือ + อัตราการหมุนเวียนลูกหนี้"
    },
    "working_capital_turnover": {
      "type": "number",
      "description": "รายได้หารด้วยเงินทุนหมุนเวียนเฉลี่ย"
    },
    "current_ratio": {
      "type": "number",
      "description": "สินทรัพย์หมุนเวียนหารด้วยหนี้สินหมุนเวียน"
    },
    "quick_ratio": {
      "type": "number",
      "description": "สินทรัพย์สภาพคล่องหารด้วยหนี้สินหมุนเวียน"
    },
    "cash_ratio": {
      "type": "number",
      "description": "เงินสดและรายการเทียบเท่าเงินสดหารด้วยหนี้สินหมุนเวียน"
    },
    "operating_cash_flow_ratio": {
      "type": "number",
      "description": "กระแสเงินสดจากการดำเนินงานหารด้วยหนี้สินหมุนเวียน"
    },
    "debt_to_equity": {
      "type": "number",
      "description": "หนี้สินทั้งหมดหารด้วยส่วนของผู้ถือหุ้น"
    },
    "debt_to_assets": {
      "type": "number",
      "description": "หนี้สินทั้งหมดหารด้วยสินทรัพย์รวม"
    },
    "interest_coverage": {
      "type": "number",
      "description": "EBIT หารด้วยค่าใช้จ่ายดอกเบี้ย"
    },
    "revenue_growth": {
      "type": "number",
      "description": "การเติบโตของรายได้แบบปีต่อปี"
    },
    "earnings_growth": {
      "type": "number",
      "description": "การเติบโตของกำไรแบบปีต่อปี"
    },
    "book_value_growth": {
      "type": "number",
      "description": "การเติบโตของมูลค่าตามบัญชีแบบปีต่อปี"
    },
    "earnings_per_share_growth": {
      "type": "number",
      "description": "การเติบโตของกำไรต่อหุ้นตลอดช่วงเวลา"
    },
    "free_cash_flow_growth": {
      "type": "number",
      "description": "การเติบโตของกระแสเงินสดอิสระตลอดช่วงเวลา"
    },
    "operating_income_growth": {
      "type": "number",
      "description": "การเติบโตของกำไรจากการดำเนินงานตลอดช่วงเวลา"
    },
    "ebitda_growth": {
      "type": "number",
      "description": "การเติบโตของ EBITDA ตลอดช่วงเวลา"
    },
    "payout_ratio": {
      "type": "number",
      "description": "เงินปันผลที่จ่ายเป็นเปอร์เซ็นต์ของกำไรสุทธิ"
    },
    "earnings_per_share": {
      "type": "number",
      "description": "กำไรสุทธิหารด้วยจำนวนหุ้นถัวเฉลี่ยถ่วงน้ำหนักที่ออกจำหน่ายแล้ว"
    },
    "book_value_per_share": {
      "type": "number",
      "description": "ส่วนของผู้ถือหุ้นหารด้วยจำนวนหุ้นที่ออกจำหน่ายแล้ว"
    },
    "free_cash_flow_per_share": {
      "type": "number",
      "description": "กระแสเงินสดอิสระหารด้วยจำนวนหุ้นที่ออกจำหน่ายแล้ว"
    },
    "next_page_url": {
      "type": "string",
      "description": "URL แบบสัมบูรณ์ของหน้าถัดไปของผลลัพธ์ แสดงเฉพาะเมื่อยังมีผลลัพธ์เหลือ ให้เรียกตามเดิมเพื่อดำเนินการต่อ แต่ละหน้ามีไม่เกิน 10 รายการ"
    }
  }
}
```
