# 재무제표 검색

**API:** Data API

**Endpoint:** `POST /v1/beta/financial/financials/search/screener`

**Tags:** Financial Data

숫자 조건에 맞는 ticker를 찾습니다. 본문은 `filters`(각각 `field`, `operator`, `value`)와 `limit`을 받습니다. `results`에는 `ticker`, `currency`, `sector`, `industry`와 일치한 필터 필드가 담깁니다. 여기서 ticker를 미리 알지 않아도 작동하는 유일한 도구이며, 나머지는 모두 ticker를 입력으로 받습니다. 필터링 가능한 필드는 `get_financial_financial_metrics`가 반환하는 지표 이름입니다. 후보 목록을 만든 뒤 각 종목의 상세 정보를 재무제표 또는 지표 도구로 가져오세요.

### 가격 참고

- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: 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`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "required": [
    "filters"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "default": 10,
      "description": "반환할 최대 결과 수입니다."
    },
    "filters": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "field",
          "operator",
          "value"
        ],
        "properties": {
          "field": {
            "type": "string",
            "description": "필터링 기준입니다. 재무 지표 필드에는 'gt', 'lt', 'gte', 'lte', 'eq' 연산자를 사용합니다. 'ticker' 및 'cik' 필드에는 'in' 연산자를 사용해 여러 값에 대해 필터링합니다."
          },
          "operator": {
            "type": "string",
            "enum": [
              "gt",
              "lt",
              "gte",
              "lte",
              "eq",
              "in"
            ],
            "description": "비교 연산자입니다. 'in' 연산자는 필드 값이 'ticker' 또는 'cik'인 경우에만 사용할 수 있으며, 여러 값에 대해 필터링할 수 있습니다."
          },
          "value": {
            "oneOf": [
              {
                "type": "number",
                "description": "단일 값 연산자(gt, lt, gte, lte, eq)에 대해 비교할 값입니다."
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "'in' 연산자를 사용할 때 비교할 ticker 또는 cik 값의 배열입니다."
              }
            ]
          }
        }
      },
      "minItems": 1,
      "description": "검색에 적용할 필터 객체 배열입니다."
    }
  }
}
```

## Responses

### 200 — 검색 성공 응답

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

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

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseE40Feb4D3D6B_FinancialsSearchResponse

`#/components/schemas/ResponseE40Feb4D3D6B_FinancialsSearchResponse`

```json
{
  "type": "object",
  "properties": {
    "search_results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ticker": {
            "type": "string",
            "description": "회사의 티커 심볼입니다."
          },
          "report_period": {
            "type": "string",
            "format": "date",
            "description": "재무 데이터의 보고 기간입니다."
          },
          "period": {
            "type": "string",
            "enum": [
              "annual",
              "quarterly",
              "ttm"
            ],
            "description": "재무 데이터의 기간입니다."
          },
          "currency": {
            "type": "string",
            "description": "재무 데이터의 통화입니다."
          }
        },
        "additionalProperties": {
          "type": "string",
          "description": "검색 기준에 따른 추가 재무 지표입니다."
        }
      }
    }
  }
}
```