Financial Data
Company fundamentals, financial statements, market prices and economic data.
SEC 공시 항목 조회
하나의 SEC 공시 내 번호가 매겨진 항목의 전체 텍스트입니다. ticker, filing_type(10-K, 10-Q, 8-K), year는 모두 필수이며 quarter, item, accession_number, include_exhibits로 더 좁힐 수 있습니다. number, title, 전체 text가 담긴 items와 filing_url, accession_number를 반환합니다. 크기에 유의하세요. 10-K는 전체 산문 약 19개 항목으로 반환되므로 문서 전체가 정말 필요하지 않다면 특정 item을 요청하세요. 먼저 어떤 공시를 열지 찾으려면 get_financial_filings를 사용하세요.
가격 참고
- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.02.
- 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: stringaccession
_number 8-K인 경우 공시의 접수 번호입니다.
- 유형: string 열거형filing
_type 필수공시 유형입니다.
값- 10
- K - 10
- Q - 8
- K
- 유형: booleaninclude
_exhibits 연결된 첨부 자료의 원본 텍스트를 포함할지 여부입니다. 8-K 공시에만 적용됩니다. true이면 첨부 객체에 전체 첨부 내용이 담긴 'text' 필드가 포함됩니다.
- 유형: string 열거형item
가져올 항목입니다.
값- Item
-1 - Item
-1 A - Item
-1 B - Item
-2 - Item
-3
- 유형: integerquarter
10-Q인 경우 공시의 분기입니다.
- 유형: stringticker필수
티커 심볼입니다.
- 유형: integeryear필수
공시 연도입니다.
- 유형: object · ResponseE40Feb4D3D6B_FilingItemsResponse200
SEC 공시 항목 응답
- 유형: stringaccession
_number 공시의 접수 번호입니다.
- 유형: stringcik
회사의 CIK(Central Index Key)입니다.
- 유형: stringfiling
_type 공시 유형입니다.
- 유형: array object[] · ResponseE40Feb4D3D6B_FilingItem[]items
- exhibits유형: array object[] · ResponseE40Feb4D3D6B_Exhibit[]
이 항목에 연결된 첨부 자료 배열입니다. 첨부 자료가 있는 8-K 공시에만 표시됩니다.
- description유형: string
첨부 자료의 설명입니다.
- number유형: string
첨부 자료 번호(예: '99.1')입니다.
- text유형: string
첨부 자료의 원본 텍스트 내용입니다. 'include_exhibits' 매개변수가 true로 설정된 경우에만 포함됩니다.
- url유형: string 형식: uri
SEC 웹사이트의 첨부 자료 문서 URL입니다.
- name유형: string
항목 이름입니다.
- number유형: string
항목 번호입니다.
- text유형: string
항목 텍스트입니다.
- 유형: integerquarter
공시의 분기입니다.
- 유형: stringresource
리소스 유형 식별자입니다.
- 유형: stringticker
회사의 티커 심볼입니다.
- 유형: integeryear
공시 연도입니다.
application/json - 유형: object · ResponseE40Feb4D3D6B_FilingItemsAccepted202
공시가 아직 준비 중입니다. 응답 본문의 result_url을 폴링하여 결과를 가져오세요. 이 응답에는 요금이 청구되지 않습니다.
- 유형: stringaccession
_number 준비 중인 공시의 접수 번호입니다.
- 유형: string 형식: date-timeestimated
_ready _at 공시가 준비될 예상 시점입니다.
- 유형: stringmessage
다음에 수행할 작업에 대한 사람이 읽을 수 있는 설명입니다.
- 유형: string 형식: uuidrequest
_id 이 요청의 식별자이며 지원팀에 문의할 때 유용합니다.
- 유형: stringresult
_url 결과를 폴링할 URL입니다.
- 열거형status상수:processing
202 응답에서는 항상 'processing'입니다.
값- processing
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl 'https://openapi.felo.ai/v1/beta/financial/filings/items?filing_type=10-K&ticker=&year=1' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"resource": "string",
"ticker": "string",
"cik": "string",
"filing_type": "string",
"accession_number": "string",
"year": 1,
"quarter": 1,
"items": [
{
"number": "string",
"name": "string",
"text": "string",
"exhibits": [
{
"number": "string",
"description": "string",
"url": "https://example.com",
"text": "string"
}
]
}
]
}