기업 스크리너 API 레퍼런스
최신 재무 지표에 대한 필터로 기업을 찾고, 최대 10개 기업의 재무 항목을 읽습니다
개요
스크리너는 최신 재무 수치가 사용자가 정한 조건을 충족하는 상장 기업을, Narwhal이 보유한 공시 기관 전반에서 찾습니다. 순이익률 20퍼센트 초과 같은 필터를 보내면, 조건에 맞는 기업과 요청한 수치를 반환합니다. 모든 요청에는 Bearer 키가 필요하며, REST와 MCP는 하나의 크레딧 잔액을 함께 사용합니다.
경로는 세 가지입니다. 첫 번째는 선별합니다. 두 번째는 선별에 쓸 수 있는 모든 필드, 연산자, 통화, 공시 기관을 나열하며 비용이 들지 않습니다. 세 번째는 이미 알고 있는 최대 10개 기업의 선택한 재무 항목을 한 번의 요청으로 반환합니다. 기업은 공시 API의 ID, 예를 들어 usa:0000320193으로 지정합니다.
각 기업에는 기준마다 한 행이 있습니다. 최신 회계연도(annual), 최신 분기(quarterly), 최근 네 분기의 합(ttm)입니다. 행은 매일 밤 공시에서 다시 만들어지며, 언제 만들어졌는지는 필터 목록의 built_에 나옵니다. 금액은 기업 자신의 통화이며 환산되지 않으므로, 금액에 대한 필터나 정렬에는 currency가 필요합니다. 각 금액에는 접미사 _가 붙은 짝 필드도 있습니다. 예를 들어 revenue_이며, 통화는 필요하지 않습니다. 현재 _ 수치는 미국 달러로 보고하는 기업에만 채워지므로, _ 필터는 그 기업들만 반환합니다.
스크리너는 재무 수치를 기반으로 합니다. 가격 필드는 해당 기업에 대해 그 작업이 실행된 뒤 일별 종가로 채워지며, 그전에는 비어 있습니다. 기업이 보고하지 않은 수치는 행에서 제외되며, 어떤 필드에 값이 없는 기업은 그 필드에 대한 필터와 일치하지 않습니다.
기본 URL: https:/. 아래 각 경로는 같은 매개변수를 가진 별도의 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개까지 받습니다. 각 필드가 받는 연산자는 필터 목록에 있으며, 필드에 맞지 않는 필터는 이유와 함께 400invalid_입니다. 텍스트 값은 대소문자를 구분하지 않고 일치시킵니다.query limit은 지정하지 않으면 25이고 최대 100입니다.order_가 없으면 기업은 기업 ID 순서로 나옵니다.by order_에는 숫자 필드를 쓸 수 있고,by order는asc를 지정하지 않으면desc입니다.- 페이지는
next_로 끝날 수 있습니다. 다른 매개변수는 그대로 두고 이를cursor cursor로 다시 보내세요. 다른 쿼리의 커서는 400invalid_입니다.cursor fields는 반환할 숫자 필드를 최대 106개까지 지정합니다. 지정하지 않으면 행에는 필터나 정렬에 쓴 필드가 들어가고, 그런 필드가 없으면 매출, 순이익, 총자산이 들어갑니다. 숫자는 소수 문자열이며, 기업에 값이 없는 필드는 제외됩니다.- 이후 공시에서 수치가 정정된 경우 스크리너는 정정된 값을 보여 주며, 재무 경로와 같습니다.
as_는 과거의 특정일 기준으로 기업을 선별하며, 2010년 1월 31일부터 가능합니다. 행은 월말 기준으로 보관되므로, 공시는 제출된 다음 월말부터 나타납니다. 오늘 상장되어 있는 기업만 대상이며, 최신 수치의 종료일이 그 날짜보다 18개월 넘게 앞선 기업은 제외됩니다. 가격 필드는of as_와 함께 쓸 수 없으며, 미래 날짜는 400of invalid_입니다.query - 재무 항목은
tickers를 최대 10개,line_를 최대 20개까지 받으며,items 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_로 페이지를 넘깁니다. 가격은 반환된 기업 수에 따라 정해지며, 10개마다 호출 1회로 올림합니다.
각 필터는 field, operator(gt, gte, lt, lte, eq, ne 또는 in), value를 가진 객체입니다. value는 숫자 또는 텍스트이고, in에서는 목록이며, 날짜는 YYYY-MM-DD로 씁니다.
가격은 페이지의 기업 10개마다 호출 1회이며 올림하고, 빈 페이지는 무료입니다. 위의 제한을 참고하세요.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
basis | body | 아니요 | one of annual, quarterly, ttm | 각 기업의 어느 행을 선별할지 정합니다. annual: 최신 회계연도. 흐름 항목은 그 연도 전체를, 잔액 항목은 연도 말 기준입니다. quarterly: 최신 분기. 흐름 항목은 그 분기만을 대상으로 하고(단독으로 제출되지 않는 4분기는 연간에서 1분기, 2분기, 3분기를 뺀 값), 잔액 항목은 분기 말 기준입니다. 증가율은 1년 전 같은 분기와 비교합니다. 연간으로만 제출하는 기업에는 분기 행이 없습니다. ttm: 최근 네 분기의 합(연간으로만 제출하거나 분기가 연속 네 개가 아닌 기업은 회계연도 자체). 잔액 항목은 마지막 분기 말 기준입니다. 증가율은 1년 전에 끝나는 네 분기와 비교합니다. 가격 비율은 제공되는 경우, 어떤 행을 요청하든 이 기준을 씁니다. |
filters | body | 아니요 | 객체 목록 | 기업이 충족해야 하는 조건이며, 각각 {field, operator, value}입니다. 최대 20개입니다. 필터가 없으면 모든 기업이 일치합니다. |
currency | body | 아니요 | 문자열 | 이 통화로 보고하는 기업만 대상입니다. 금액은 환산되지 않으므로, 금액 또는 주당 필드에 대한 필터나 정렬에는 여기에 통화 하나를 지정하거나 currency의 eq 필터가 필요합니다. |
fields | body | 아니요 | list of string | 반환할 숫자 필드. 기본값은 필터나 정렬에 쓴 필드. |
order_ | body | 아니요 | 문자열 | 숫자 필드. 기본값은 기업 ID. |
order | body | 아니요 | one of asc, desc | desc는 order_ 값이 가장 높은 것을 먼저, asc는 가장 낮은 것을 먼저 둡니다. 기본값은 desc입니다. |
lang | body | 아니요 | one of en, original | en은 알려진 경우 기업의 영어 이름을, original은 공시된 그대로의 이름을 보냅니다. 기본값은 en입니다. |
as_ | body | 아니요 | 날짜 | 그 날짜 기준의 기업을 선별합니다. 각 기업의 최신 행은 그때까지 제출된 공시로 만들며, 2010-01-31부터 가능합니다. 행은 월말 기준으로 보관되므로, 공시는 제출된 다음 월말부터 나타납니다(그보다 일찍 나타나지 않습니다). 오늘 상장되어 있는 기업만 대상이며, 최신 수치의 종료일이 그 날짜보다 18개월 넘게 앞선 기업은 제외됩니다. 가격 필드(close, market_, 가격 비율과 수익률)는 보관되지 않으며 이 매개변수와 함께 쓸 수 없습니다. |
limit | body | 아니요 | 정수 | 페이지의 기업 수로 1에서 100까지입니다. 기본값은 25입니다. 페이지는 기업 10개마다 호출 1회로 청구되며 올림합니다. |
cursor | body | 아니요 | 문자열 | 이전 페이지의 next_. 다른 매개변수는 동일하게 유지합니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
companies | 객체 목록 | 항상 | 이 페이지의 기업이며 기업당 한 행입니다. 빈 목록은 일치하는 것이 없다는 뜻입니다. |
companies[].id | 문자열 | 항상 | 기업 ID. 다른 공시 API 경로에서 사용합니다. |
companies[].name | 문자열 | 항상 | 기업 이름. lang이 en이고 영어 이름이 알려진 경우 영어 이름입니다. |
companies[].ticker | 문자열 | 선택 | 기업이 거래되는 티커(있는 경우). |
companies[].registry | one 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_ | 정수 | 선택 | 행의 회계연도. |
companies[].period_ | 날짜 | 선택 | 행 기간의 마지막 날. |
companies[].filed_ | 날짜 | 선택 | 행의 출처인 공시가 제출된 날. |
next_ | 문자열 | 선택 | 다음 페이지를 읽으려면 이를 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_.
매개변수
이 라우트는 파라미터가 없습니다.
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
fields | 객체 목록 | 항상 | |
fields[].field | 문자열 | 항상 | 필드 이름이며 filters, order_, fields에서 쓰는 그대로입니다. |
fields[].type | one of text, date, integer, amount, per_share, shares, percent, ratio, days, usd | 항상 | 필드가 담는 값의 종류. |
fields[].operators | list of one of gt, gte, lt, lte, eq, ne, in | 항상 | 이 필드에 대한 필터가 받는 연산자. |
fields[].unit | 문자열 | 선택 | 값의 단위(있는 경우). |
fields[].description | 문자열 | 항상 | 필드가 무엇인지. |
bases | 객체 목록 | 항상 | |
bases[].basis | one of annual, quarterly, ttm | 항상 | basis에 쓸 수 있는 값. |
bases[].description | 문자열 | 항상 | 각 기업의 어느 행을 선별하는지. |
currencies | 객체 목록 | 항상 | 기업이 보고에 쓰는 통화와 통화별 기업 수. |
currencies[].value | 문자열 | 항상 | 통화 코드. |
currencies[].companies | 정수 | 항상 | 그 통화로 보고하는 기업 수. |
registries | 객체 목록 | 항상 | |
registries[].value | 문자열 | 항상 | 공시 기관 코드. |
registries[].companies | 정수 | 항상 | 그 공시 기관이 보유한 기업 수. |
built_ | 날짜·시간 | 선택 | 스크리너 테이블이 마지막으로 재구축된 시각. |
max_ | 정수 | 선택 | 선별 한 번에 받는 필터의 최대 개수. |
max_ | 정수 | 선택 | 한 페이지에 담기는 기업의 최대 수. |
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_에 나열됩니다. 찾은 기업 하나당 호출 1회입니다.
period는 지정하지 않으면 annual입니다. 응답에는 요청한 기간의 행이 그 이름 아래 최신순으로 들어가며, ttm 행은 ttm 아래에 들어갑니다.
가격은 찾은 기업 하나당 호출 1회이며 최대 10개입니다. 하나도 찾지 못한 요청은 무료입니다.
MCP: 도구 filings_.
매개변수
| 매개변수 | 위치 | 필수 | 유형 | 의미 |
|---|---|---|---|---|
tickers | body | 예 | list of string | 기업 ID(usa:0000320193), 공시 기관이 붙은 티커(usa:AAPL, jpn:7203) 또는 공시 기관 없는 미국 티커(AAPL). |
line_ | body | 예 | list of string | 표준 항목명이며 재무 경로의 fields와 같습니다. |
period | body | 아니요 | one of annual, semiannual, quarterly, ttm | ttm은 각 분기 말 기준 최근 네 분기의 합입니다(대차대조표 항목은 마지막 분기의 값이며, 연간으로만 제출하는 기업은 회계연도를 씁니다). 나머지는 재무 경로와 같습니다. |
start_ | body | 아니요 | 날짜 | 이 날짜 이후에 끝나는 기간만. |
end_ | body | 아니요 | 날짜 | 이 날짜 이전에 끝나는 기간만. |
limit | body | 아니요 | 정수 | 기업당 기간 수이며 최신순입니다. 기본값은 1이고, 날짜를 지정하면 날짜 범위의 모든 기간(최대 40개)입니다. |
응답 필드
| 필드 | 유형 | 전송 | 의미 |
|---|---|---|---|
results | 객체 목록 | 항상 | |
results[].id | 문자열 | 항상 | 기업 ID입니다. |
results[].currency | 문자열 | 선택 | 수치의 통화. |
results[].basis | one of consolidated, standalone | 선택 | 수치가 연결 기준인지 별도 기준인지. |
results[].from_ | 정수 | 선택 | 행이 거슬러 올라가는 첫 회계연도. |
results[].annual | 객체 목록 | 선택 | 연간 행이며 최신순입니다. period가 annual일 때 보냅니다. |
results[].annual[].fy | 정수 | 항상 | 행의 회계연도. |
results[].annual[].fq | 정수 | 선택 | 회계 분기이며 분기 행에 사용합니다. |
results[].annual[].fh | 정수 | 선택 | 회계 반기이며 반기 행에 사용합니다. |
results[].annual[].end | 날짜 | 항상 | 기간의 마지막 날. |
results[].annual[].form | 문자열 | 선택 | 행에 표시되는 값의 대부분을 제공하는 공시의 양식으로, 예를 들어 10-K입니다. 동률이면 가장 최근에 제출된 것이 우선합니다. 요청한 필드만 계산에 넣으므로, line_가 다른 두 요청에서는 form이 다를 수 있습니다. |
results[].annual[].currency | 문자열 | 선택 | 가격의 통화입니다. |
results[].annual[].derived | list 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_가 다른 두 요청에서는 form이 다를 수 있습니다. |
results[].semiannual[].currency | 문자열 | 선택 | 가격의 통화입니다. |
results[].semiannual[].derived | list 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_가 다른 두 요청에서는 form이 다를 수 있습니다. |
results[].quarterly[].currency | 문자열 | 선택 | 가격의 통화입니다. |
results[].quarterly[].derived | list of string | 선택 | 공시에서 가져온 것이 아니라 Narwhal이 계산한 행의 항목. |
results[].as_ | 날짜 | 선택 | 수치의 기준일이며 기간에 기준일이 필요한 경우에만 보냅니다. |
results[].ttm | 객체 목록 | 선택 | 최근 네 분기 합 행이며 최신순입니다. period가 ttm일 때 보냅니다. |
results[].ttm[].fy | 정수 | 항상 | 행의 회계연도. |
results[].ttm[].fq | 정수 | 선택 | 회계 분기이며 분기 행에 사용합니다. |
results[].ttm[].fh | 정수 | 선택 | 회계 반기이며 반기 행에 사용합니다. |
results[].ttm[].end | 날짜 | 항상 | 기간의 마지막 날. |
results[].ttm[].form | 문자열 | 선택 | 행에 표시되는 값의 대부분을 제공하는 공시의 양식으로, 예를 들어 10-K입니다. 동률이면 가장 최근에 제출된 것이 우선합니다. 요청한 필드만 계산에 넣으므로, line_가 다른 두 요청에서는 form이 다를 수 있습니다. |
results[].ttm[].currency | 문자열 | 선택 | 가격의 통화입니다. |
results[].ttm[].derived | list of string | 선택 | 공시에서 가져온 것이 아니라 Narwhal이 계산한 행의 항목. |
not_ | list 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_. 확인 API 오류 코드와 크레딧 형식과 크레딧 헤더에 대한 설명이 있습니다. 실패한 요청에는 요금이 부과되지 않습니다.
| 코드 | 상태 | 의미 |
|---|---|---|
invalid_ | 400 | 매개변수가 없거나, 알 수 없거나, 중복되었거나, 범위를 벗어났습니다. |
invalid_ | 400 | 이 요청이 반환한 커서가 아니거나, 다른 요청의 커서입니다. |
insufficient_ | 402 | 크레딧 잔액이 요청 비용보다 적습니다. |
screener_ | 503 | 야간 스크리너 테이블이 아직 구축되지 않았습니다. 나중에 다시 시도하세요. 이 경우 청구되지 않습니다. |
company_ | 503 | `as_of` 선별을 제때 읽지 못했습니다. 잠시 후 다시 시도하세요. 이 경우 청구되지 않습니다. |
이 페이지가 도움이 되었나요?