기업 재무 데이터 조회

기업에 대한 개요를 조회합니다.

GET https://api.deepsearch.com/v2/companies/{{symbol}}/financials

Request Path Parameter

Name	Type	Description	Example
symbol*	String	기업의 거래소:ticker	NASDAQ:AAPL 또는 APPL

Request Query Parameter

• date_from 과 date_to가 주어지는 경우 period 필드보다 우선함

Name	Type	Description	Example
date_from	String (YYYY-MM-DD)	가져올 기간의 시작 일	2021-01-01
date_to	String (YYYY-MM-DD)	가져올 기간의 종료 일	2021-01-01
period	Enum { "1 년 전": "1y", "3 년 전": "3y", "5 년 전": "5y" }	주식 정보를 가져올 기간(오늘로부터 과거까지 떨어진 기간)	3y(default)

Response Example

200: OK

{
    "detail": {
        "message": "success",
        "code": "SUCCESS",
        "ok": true
    },
    "data": [
        {
            "symbol": {{기업 ticker* (string)}},
            "name": {{기업 이름* (string)}},
            "name_ko": {{기업 한글 이름 (string)}},
            "reported_currency": {{통화* (string)}},
            "fiscal_end_date": {{회계 결산 일자* (string, YYYY-MM-DD)}},
            "revenue": {{매출액 (string)}},
            "gross_profit": {{매출총이익 (string)}},
            "operating_profit": {{영업이익 (string)}},
            "net_income": {{순손익 (string)}},
            "asset": {{총자산* (string)}},
            "liability": {{총부채* (string)}},
            "equity": {{총자본* (string)}},
        },
        ...(and more)
    ]
}

400: Bad Request

{
    "detail": {
        "message": "Must be in NASDAQ:AAPL or APPL format",
        "code": "BAD_REQUEST",
        "ok": false
    },
    "ok": false
}