전체 문서 탐색

기업 스크리너 API 레퍼런스

최신 재무 지표에 대한 필터로 기업을 찾고, 최대 10개 기업의 재무 항목을 읽습니다

개요

스크리너는 최신 재무 수치가 사용자가 정한 조건을 충족하는 상장 기업을, Narwhal이 보유한 공시 기관 전반에서 찾습니다. 순이익률 20퍼센트 초과 같은 필터를 보내면, 조건에 맞는 기업과 요청한 수치를 반환합니다. 모든 요청에는 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.

경로는 세 가지입니다. 첫 번째는 선별합니다. 두 번째는 선별에 쓸 수 있는 모든 필드, 연산자, 통화, 공시 기관을 나열하며 비용이 들지 않습니다. 세 번째는 이미 알고 있는 최대 10개 기업의 선택한 재무 항목을 한 번의 요청으로 반환합니다. 기업은 공시 API의 ID, 예를 들어 usa:0000320193으로 지정합니다.

각 기업에는 기준마다 한 행이 있습니다. 최신 회계연도(annual), 최신 분기(quarterly), 최근 네 분기의 합(ttm)입니다. 행은 매일 밤 공시에서 다시 만들어지며, 언제 만들어졌는지는 필터 목록의 built_at에 나옵니다. 금액은 기업 자신의 통화이며 환산되지 않으므로, 금액에 대한 필터나 정렬에는 currency가 필요합니다. 각 금액에는 접미사 _usd가 붙은 짝 필드도 있습니다. 예를 들어 revenue_usd이며, 통화는 필요하지 않습니다. 현재 _usd 수치는 미국 달러로 보고하는 기업에만 채워지므로, _usd 필터는 그 기업들만 반환합니다.

스크리너는 재무 수치를 기반으로 합니다. 가격 필드는 해당 기업에 대해 그 작업이 실행된 뒤 일별 종가로 채워지며, 그전에는 비어 있습니다. 기업이 보고하지 않은 수치는 행에서 제외되며, 어떤 필드에 값이 없는 기업은 그 필드에 대한 필터와 일치하지 않습니다.

기본 URL: https://api.narwhalapi.com. 아래 각 경로는 같은 매개변수를 가진 별도의 MCP 도구입니다.

한 기업의 재무제표는 다음 페이지에 있습니다: 기업 공시 API로 재무 정보 조회.

기업 ID는 공시 API 기업 검색이 반환하는 값입니다.

모든 계정에 제공되는 것

항목모든 계정
선별포함. 반환된 기업 10개마다 호출 1회, 올림
필터 목록포함. 무료
재무 항목포함. 찾은 기업 하나당 호출 1회, 최대 10개

확인 요금 페이지에서 호출당 비용을 확인할 수 있습니다. 라우트에 별도 안내가 없으면 요청은 해당 API의 가격으로 청구됩니다.

  • 선별은 반환하는 페이지의 기업 수로 청구됩니다. 요금은 Companies 가격인 호출 1,000회당 $10, 즉 호출 1회당 $0.01이며, 기업 10개마다 호출 1회로 올림합니다. 기업 1개에서 10개는 호출 1회($0.01), 11개에서 20개는 2회($0.02), 100개가 가득 찬 페이지는 10회($0.10)입니다. 일치하는 기업이 없는 선별은 무료이며, 모든 오류도 무료입니다.
  • 각 페이지는 그 페이지의 행 수로 청구되므로, 페이지를 나눠도 기업당 가격은 달라지지 않습니다. 같은 기업이라면 10개씩 나눈 페이지와 100개짜리 한 페이지의 비용이 같습니다. 10의 배수가 아닌 페이지는 올림하므로 limit이 1이면 기업 하나에 $0.01입니다. 커서로 결과 전체를 읽으면 기업 10개마다 항상 최소 호출 1회가 듭니다.
  • 요청 비용은 X-Narwhal-Cost 응답 헤더에 소수 여섯 자리의 달러로 들어 있습니다(기업 23개 페이지는 0.030000). X-Narwhal-Balance는 남은 잔액입니다. 응답 본문에는 비용 필드가 없습니다. MCP에서도 같은 금액이 잔액에서 차감되고 호출 로그에 표시됩니다. 일치하는 기업이 없는 선별은 0.000000으로 표시됩니다.
  • 잔액이 호출 1회보다 적으면 실행 전에, 잔액으로 페이지 전체를 감당할 수 없으면 실행 후에 402 insufficient_credits로 거부됩니다. 두 경우 모두 기업은 전달되지 않고 청구도 되지 않습니다. 더 적게 내려면 더 작은 limit을 보내세요.
  • 선별 한 번에 필터를 최대 20개 쓸 수 있습니다. in 연산자는 값을 1개에서 50개까지 받습니다. 각 필드가 받는 연산자는 필터 목록에 있으며, 필드에 맞지 않는 필터는 이유와 함께 400 invalid_query입니다. 텍스트 값은 대소문자를 구분하지 않고 일치시킵니다.
  • limit은 지정하지 않으면 25이고 최대 100입니다. order_by가 없으면 기업은 기업 ID 순서로 나옵니다. order_by에는 숫자 필드를 쓸 수 있고, order는 asc를 지정하지 않으면 desc입니다.
  • 페이지는 next_cursor로 끝날 수 있습니다. 다른 매개변수는 그대로 두고 이를 cursor로 다시 보내세요. 다른 쿼리의 커서는 400 invalid_cursor입니다.
  • fields는 반환할 숫자 필드를 최대 106개까지 지정합니다. 지정하지 않으면 행에는 필터나 정렬에 쓴 필드가 들어가고, 그런 필드가 없으면 매출, 순이익, 총자산이 들어갑니다. 숫자는 소수 문자열이며, 기업에 값이 없는 필드는 제외됩니다.
  • 이후 공시에서 수치가 정정된 경우 스크리너는 정정된 값을 보여 주며, 재무 경로와 같습니다.
  • as_of는 과거의 특정일 기준으로 기업을 선별하며, 2010년 1월 31일부터 가능합니다. 행은 월말 기준으로 보관되므로, 공시는 제출된 다음 월말부터 나타납니다. 오늘 상장되어 있는 기업만 대상이며, 최신 수치의 종료일이 그 날짜보다 18개월 넘게 앞선 기업은 제외됩니다. 가격 필드는 as_of와 함께 쓸 수 없으며, 미래 날짜는 400 invalid_query입니다.
  • 재무 항목은 tickers를 최대 10개, line_items를 최대 20개까지 받으며, limit은 기업당 최대 40개 기간입니다. 어떤 기업과도 일치하지 않는 티커는 not_found에 나열되고 비용이 들지 않으며, 같은 기업을 두 번 지정하면(AAPL과 usa:AAPL) 한 번만 찾아서 한 번만 청구합니다. 요금제 제한, 보류된 수치(타당성 검사를 통과하지 못해 어떤 응답에도 포함되지 않는 수치), 철회된 공시는 재무 경로와 똑같이 처리됩니다.

엔드포인트

Each route is marked GET or POST. A POST route takes a JSON body, and its parameters below are the fields of that body. Every route needs your key in the Authorization: Bearer 헤더입니다. 예시는 응답의 형태를 보여 줄 뿐이며 실시간 데이터가 아닙니다.

기업을 재무 지표로 선별

POST /v1/companies/screen

공시 기관 전반에서 상장 기업을 최신 회계연도 기준으로 찾습니다. 조건은 필터 목록에 있는 필드에 대한 filters 목록, 선택적인 정렬, 반환할 필드입니다. next_cursor로 페이지를 넘깁니다. 가격은 반환된 기업 수에 따라 정해지며, 10개마다 호출 1회로 올림합니다.

각 필터는 field, operator(gt, gte, lt, lte, eq, ne 또는 in), value를 가진 객체입니다. value는 숫자 또는 텍스트이고, in에서는 목록이며, 날짜는 YYYY-MM-DD로 씁니다.

가격은 페이지의 기업 10개마다 호출 1회이며 올림하고, 빈 페이지는 무료입니다. 위의 제한을 참고하세요.

MCP: 도구 filings_screen_companies.

매개변수

매개변수위치필수유형의미
basisbody아니요one of annual, quarterly, ttm각 기업의 어느 행을 선별할지 정합니다. annual: 최신 회계연도. 흐름 항목은 그 연도 전체를, 잔액 항목은 연도 말 기준입니다. quarterly: 최신 분기. 흐름 항목은 그 분기만을 대상으로 하고(단독으로 제출되지 않는 4분기는 연간에서 1분기, 2분기, 3분기를 뺀 값), 잔액 항목은 분기 말 기준입니다. 증가율은 1년 전 같은 분기와 비교합니다. 연간으로만 제출하는 기업에는 분기 행이 없습니다. ttm: 최근 네 분기의 합(연간으로만 제출하거나 분기가 연속 네 개가 아닌 기업은 회계연도 자체). 잔액 항목은 마지막 분기 말 기준입니다. 증가율은 1년 전에 끝나는 네 분기와 비교합니다. 가격 비율은 제공되는 경우, 어떤 행을 요청하든 이 기준을 씁니다.
filtersbody아니요객체 목록기업이 충족해야 하는 조건이며, 각각 {field, operator, value}입니다. 최대 20개입니다. 필터가 없으면 모든 기업이 일치합니다.
currencybody아니요문자열이 통화로 보고하는 기업만 대상입니다. 금액은 환산되지 않으므로, 금액 또는 주당 필드에 대한 필터나 정렬에는 여기에 통화 하나를 지정하거나 currency의 eq 필터가 필요합니다.
fieldsbody아니요list of string반환할 숫자 필드. 기본값은 필터나 정렬에 쓴 필드.
order_bybody아니요문자열숫자 필드. 기본값은 기업 ID.
orderbody아니요one of asc, descdesc는 order_by 값이 가장 높은 것을 먼저, asc는 가장 낮은 것을 먼저 둡니다. 기본값은 desc입니다.
langbody아니요one of en, originalen은 알려진 경우 기업의 영어 이름을, original은 공시된 그대로의 이름을 보냅니다. 기본값은 en입니다.
as_ofbody아니요날짜그 날짜 기준의 기업을 선별합니다. 각 기업의 최신 행은 그때까지 제출된 공시로 만들며, 2010-01-31부터 가능합니다. 행은 월말 기준으로 보관되므로, 공시는 제출된 다음 월말부터 나타납니다(그보다 일찍 나타나지 않습니다). 오늘 상장되어 있는 기업만 대상이며, 최신 수치의 종료일이 그 날짜보다 18개월 넘게 앞선 기업은 제외됩니다. 가격 필드(close, market_cap, 가격 비율과 수익률)는 보관되지 않으며 이 매개변수와 함께 쓸 수 없습니다.
limitbody아니요정수페이지의 기업 수로 1에서 100까지입니다. 기본값은 25입니다. 페이지는 기업 10개마다 호출 1회로 청구되며 올림합니다.
cursorbody아니요문자열이전 페이지의 next_cursor. 다른 매개변수는 동일하게 유지합니다.

응답 필드

필드유형전송의미
companies객체 목록항상이 페이지의 기업이며 기업당 한 행입니다. 빈 목록은 일치하는 것이 없다는 뜻입니다.
companies[].id문자열항상기업 ID. 다른 공시 API 경로에서 사용합니다.
companies[].name문자열항상기업 이름. lang이 en이고 영어 이름이 알려진 경우 영어 이름입니다.
companies[].ticker문자열선택기업이 거래되는 티커(있는 경우).
companies[].registryone of usa, jpn, kor, gbr, twn, aut, bel, cyp, cze, dnk, est, esp, fin, fra, grc, hrv, hun, isl, ita, ltu, lux, lva, mlt, nld, nor, pol, prt, rou, swe, svn, svk항상기업이 제출하는 공시 기관.
companies[].country문자열선택기업의 국가이며 ISO 3166-1 alpha-3 코드입니다.
companies[].isic문자열선택기업의 ISIC 산업 코드.
companies[].currency문자열선택기업이 보고에 사용하는 통화.
companies[].fiscal_year정수선택행의 회계연도.
companies[].period_end날짜선택행 기간의 마지막 날.
companies[].filed_on날짜선택행의 출처인 공시가 제출된 날.
next_cursor문자열선택다음 페이지를 읽으려면 이를 cursor로 다시 보내세요. 마지막 페이지에서는 제외됩니다.
요청
curl -X POST -H "Authorization: Bearer $NARWHAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":[{"field":"net_margin","operator":"gt","value":20},{"field":"revenue","operator":"gt","value":50000000000}],"currency":"USD","order_by":"net_margin","fields":["net_margin","revenue"],"limit":3}' \
  "https://api.narwhalapi.com/v1/companies/screen"
응답 예시
{
  "companies": [
    {
      "id": "usa:0000723125",
      "name": "MICRON TECHNOLOGY INC",
      "ticker": "MU",
      "registry": "usa",
      "country": "USA",
      "isic": "2610",
      "currency": "USD",
      "fiscal_year": 2026,
      "period_end": "2026-09-03",
      "filed_on": "2026-10-09",
      "revenue": "133188000000",
      "net_margin": "63.7963"
    },
    {
      "id": "usa:0001045810",
      "name": "NVIDIA CORP",
      "ticker": "NVDA",
      "registry": "usa",
      "country": "USA",
      "isic": "2610",
      "currency": "USD",
      "fiscal_year": 2026,
      "period_end": "2026-01-25",
      "filed_on": "2026-02-25",
      "revenue": "215938000000",
      "net_margin": "55.6025"
    },
    {
      "id": "usa:0000789019",
      "name": "MICROSOFT CORP",
      "ticker": "MSFT",
      "registry": "usa",
      "country": "USA",
      "isic": "5820",
      "currency": "USD",
      "fiscal_year": 2026,
      "period_end": "2026-06-30",
      "filed_on": "2026-07-29",
      "revenue": "331839000000",
      "net_margin": "40.3054"
    }
  ],
  "next_cursor": "eyJpIjo3MjYsImtpbmQiOiJzY3JlZW4iLCJvIjoiNDAuMzA1NCIsInEiOiJlMWFjYzEzMjM1NTE5OGNmIiwidiI6MX0.z_-8qfS3wrPvM52pvfH2QEc6Z8LcktMIJH8zF5yjvmo"
}

스크리너의 필드와 제한 나열

GET /v1/companies/screen/filters

선별에서 필터, 정렬, 반환할 수 있는 모든 필드를 유형, 단위, 연산자와 함께 반환합니다. 또한 기준, 스크리너가 보유한 통화와 공시 기관, 그리고 제한도 반환합니다. 무료이며 이 경로는 청구되지 않습니다.

응답은 모든 계정에서 같습니다. 통화와 공시 기관별 기업 수는 가장 최근 재구축 기준입니다.

MCP: 도구 filings_get_screen_filters.

매개변수

이 라우트는 파라미터가 없습니다.

응답 필드

필드유형전송의미
fields객체 목록항상
fields[].field문자열항상필드 이름이며 filters, order_by, fields에서 쓰는 그대로입니다.
fields[].typeone of text, date, integer, amount, per_share, shares, percent, ratio, days, usd항상필드가 담는 값의 종류.
fields[].operatorslist of one of gt, gte, lt, lte, eq, ne, in항상이 필드에 대한 필터가 받는 연산자.
fields[].unit문자열선택값의 단위(있는 경우).
fields[].description문자열항상필드가 무엇인지.
bases객체 목록항상
bases[].basisone of annual, quarterly, ttm항상basis에 쓸 수 있는 값.
bases[].description문자열항상각 기업의 어느 행을 선별하는지.
currencies객체 목록항상기업이 보고에 쓰는 통화와 통화별 기업 수.
currencies[].value문자열항상통화 코드.
currencies[].companies정수항상그 통화로 보고하는 기업 수.
registries객체 목록항상
registries[].value문자열항상공시 기관 코드.
registries[].companies정수항상그 공시 기관이 보유한 기업 수.
built_at날짜·시간선택스크리너 테이블이 마지막으로 재구축된 시각.
max_filters정수선택선별 한 번에 받는 필터의 최대 개수.
max_limit정수선택한 페이지에 담기는 기업의 최대 수.
요청
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/companies/screen/filters"
응답 예시
{ "fields": [ { "field": "registry", "type": "text", "operators": [ "eq", "ne", "in" ], "description": "Registry that holds the company (usa, jpn, kor, ...)." }, { "field": "revenue", "type": "amount", "operators": [ "gt", "gte", "lt", "lte", "eq", "ne", "in" ], "unit": "currency", "description": "Revenue in `currency`, for the period of the row (see `basis`)." }, { "field": "net_margin", "type": "percent", "operators": [ "gt", "gte", "lt", "lte", "eq", "ne", "in" ], "unit": "percent", "description": "Net income over revenue (revenue above zero)." }, { "field": "revenue_usd", "type": "usd", "operators": [ "gt", "gte", "lt", "lte", "eq", "ne", "in" ], "unit": "USD", "description": "revenue in US dollars: the figure times `usd_rate_avg` (the period's average rate). Empty where there is no rate. Today the `_usd` figures are filled only for companies that report in US dollars, so a `_usd` filter returns only those companies." } ], "bases": [ { "basis": "annual", "description": "The newest fiscal year. Flows cover the year; balances are at its end." }, { "basis": "quarterly", "description": "The newest quarter. Flows cover that quarter alone (a fourth quarter that is not filed on its own is the year minus the first three); balances are at its end. Growth is against the same quarter a year before. A company that files only annually has no quarterly row." }, { "basis": "ttm", "description": "The last four quarters added up (the fiscal year itself for a company that files only annually or whose quarters are not four in a row); balances are at the end of the last quarter. Growth is against the four quarters ending a year before. Price ratios, where offered, use this basis whatever row is asked for." } ], "currencies": [ { "value": "USD", "companies": 5408 }, { "value": "JPY", "companies": 3804 }, { "value": "KRW", "companies": 2628 } ], "registries": [ { "value": "usa", "companies": 5520 }, { "value": "jpn", "companies": 3784 }, { "value": "kor", "companies": 2637 } ], "built_at": "2026-11-16T04:18:58.438922Z", "max_filters": 20, "max_limit": 100 }

최대 10개 기업의 선택한 재무 항목 가져오기

POST /v1/companies/line-items

한 번의 요청으로 최대 10개 tickers의 선택한 재무 항목을 반환합니다. 각 기업의 기간이 최신순으로 나옵니다. 어떤 기업과도 일치하지 않는 티커는 not_found에 나열됩니다. 찾은 기업 하나당 호출 1회입니다.

period는 지정하지 않으면 annual입니다. 응답에는 요청한 기간의 행이 그 이름 아래 최신순으로 들어가며, ttm 행은 ttm 아래에 들어갑니다.

가격은 찾은 기업 하나당 호출 1회이며 최대 10개입니다. 하나도 찾지 못한 요청은 무료입니다.

MCP: 도구 filings_search_line_items.

매개변수

매개변수위치필수유형의미
tickersbody예list of string기업 ID(usa:0000320193), 공시 기관이 붙은 티커(usa:AAPL, jpn:7203) 또는 공시 기관 없는 미국 티커(AAPL).
line_itemsbody예list of string표준 항목명이며 재무 경로의 fields와 같습니다.
periodbody아니요one of annual, semiannual, quarterly, ttmttm은 각 분기 말 기준 최근 네 분기의 합입니다(대차대조표 항목은 마지막 분기의 값이며, 연간으로만 제출하는 기업은 회계연도를 씁니다). 나머지는 재무 경로와 같습니다.
start_datebody아니요날짜이 날짜 이후에 끝나는 기간만.
end_datebody아니요날짜이 날짜 이전에 끝나는 기간만.
limitbody아니요정수기업당 기간 수이며 최신순입니다. 기본값은 1이고, 날짜를 지정하면 날짜 범위의 모든 기간(최대 40개)입니다.

응답 필드

필드유형전송의미
results객체 목록항상
results[].id문자열항상기업 ID입니다.
results[].currency문자열선택수치의 통화.
results[].basisone of consolidated, standalone선택수치가 연결 기준인지 별도 기준인지.
results[].from_fy정수선택행이 거슬러 올라가는 첫 회계연도.
results[].annual객체 목록선택연간 행이며 최신순입니다. period가 annual일 때 보냅니다.
results[].annual[].fy정수항상행의 회계연도.
results[].annual[].fq정수선택회계 분기이며 분기 행에 사용합니다.
results[].annual[].fh정수선택회계 반기이며 반기 행에 사용합니다.
results[].annual[].end날짜항상기간의 마지막 날.
results[].annual[].form문자열선택행에 표시되는 값의 대부분을 제공하는 공시의 양식으로, 예를 들어 10-K입니다. 동률이면 가장 최근에 제출된 것이 우선합니다. 요청한 필드만 계산에 넣으므로, line_items가 다른 두 요청에서는 form이 다를 수 있습니다.
results[].annual[].currency문자열선택가격의 통화입니다.
results[].annual[].derivedlist of string선택공시에서 가져온 것이 아니라 Narwhal이 계산한 행의 항목.
results[].semiannual객체 목록선택반기 행이며 최신순입니다. period가 semiannual일 때 보냅니다.
results[].semiannual[].fy정수항상행의 회계연도.
results[].semiannual[].fq정수선택회계 분기이며 분기 행에 사용합니다.
results[].semiannual[].fh정수선택회계 반기이며 반기 행에 사용합니다.
results[].semiannual[].end날짜항상기간의 마지막 날.
results[].semiannual[].form문자열선택행에 표시되는 값의 대부분을 제공하는 공시의 양식으로, 예를 들어 10-K입니다. 동률이면 가장 최근에 제출된 것이 우선합니다. 요청한 필드만 계산에 넣으므로, line_items가 다른 두 요청에서는 form이 다를 수 있습니다.
results[].semiannual[].currency문자열선택가격의 통화입니다.
results[].semiannual[].derivedlist of string선택공시에서 가져온 것이 아니라 Narwhal이 계산한 행의 항목.
results[].quarterly객체 목록선택분기 행이며 최신순입니다. period가 quarterly일 때 보냅니다.
results[].quarterly[].fy정수항상행의 회계연도.
results[].quarterly[].fq정수선택회계 분기이며 분기 행에 사용합니다.
results[].quarterly[].fh정수선택회계 반기이며 반기 행에 사용합니다.
results[].quarterly[].end날짜항상기간의 마지막 날.
results[].quarterly[].form문자열선택행에 표시되는 값의 대부분을 제공하는 공시의 양식으로, 예를 들어 10-K입니다. 동률이면 가장 최근에 제출된 것이 우선합니다. 요청한 필드만 계산에 넣으므로, line_items가 다른 두 요청에서는 form이 다를 수 있습니다.
results[].quarterly[].currency문자열선택가격의 통화입니다.
results[].quarterly[].derivedlist of string선택공시에서 가져온 것이 아니라 Narwhal이 계산한 행의 항목.
results[].as_of날짜선택수치의 기준일이며 기간에 기준일이 필요한 경우에만 보냅니다.
results[].ttm객체 목록선택최근 네 분기 합 행이며 최신순입니다. period가 ttm일 때 보냅니다.
results[].ttm[].fy정수항상행의 회계연도.
results[].ttm[].fq정수선택회계 분기이며 분기 행에 사용합니다.
results[].ttm[].fh정수선택회계 반기이며 반기 행에 사용합니다.
results[].ttm[].end날짜항상기간의 마지막 날.
results[].ttm[].form문자열선택행에 표시되는 값의 대부분을 제공하는 공시의 양식으로, 예를 들어 10-K입니다. 동률이면 가장 최근에 제출된 것이 우선합니다. 요청한 필드만 계산에 넣으므로, line_items가 다른 두 요청에서는 form이 다를 수 있습니다.
results[].ttm[].currency문자열선택가격의 통화입니다.
results[].ttm[].derivedlist of string선택공시에서 가져온 것이 아니라 Narwhal이 계산한 행의 항목.
not_foundlist of string선택어떤 기업과도 일치하지 않는 티커 또는 ID.
요청
curl -X POST -H "Authorization: Bearer $NARWHAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tickers":["AAPL","MSFT"],"line_items":["revenue","net_income"],"limit":1}' \
  "https://api.narwhalapi.com/v1/companies/line-items"
응답 예시
{
  "results": [
    {
      "id": "usa:0000320193",
      "currency": "USD",
      "annual": [
        {
          "fy": 2026,
          "end": "2026-09-26",
          "form": "10-K",
          "derived": [],
          "revenue": "478834000000",
          "net_income": "132175000000"
        }
      ],
      "as_of": "2026-11-03"
    },
    {
      "id": "usa:0000789019",
      "currency": "USD",
      "annual": [
        {
          "fy": 2026,
          "end": "2026-06-30",
          "form": "10-K",
          "derived": [],
          "revenue": "331839000000",
          "net_income": "133749000000"
        }
      ],
      "as_of": "2026-07-29"
    }
  ],
  "not_found": []
}

오류

오류는 공통 문제 형식을 사용하며, 다음 필드를 포함합니다: request_id. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.

코드상태의미
invalid_query400매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다.
invalid_cursor400이 요청이 반환한 커서가 아니거나, 다른 요청의 커서입니다.
insufficient_credits402크레딧 잔액이 요청 비용보다 적습니다.
screener_unavailable503야간 스크리너 테이블이 아직 구축되지 않았습니다. 나중에 다시 시도하세요. 이 경우 청구되지 않습니다.
company_data_unavailable503`as_of` 선별을 제때 읽지 못했습니다. 잠시 후 다시 시도하세요. 이 경우 청구되지 않습니다.

이 페이지가 도움이 되었나요?