Twinkle HubTwinkle Hub

美股 SEC 單一申報文件 metadata

us_get_sec_filing

🇺🇸 미국읽기 전용

關鍵字 / Keywords: SEC EDGAR 美股 財報 申報 filing accession primary document 10-K 10-Q 8-K URL cite metadata single filing detail

Scope: US public companies filing with the SEC (EDGAR).

Look up one filing by CIK + accession number. Returns full metadata plus the direct URL to the primary document — the filing body is NOT downloaded inline (agents crawl on demand via original_url).

Endpoint: https://data.sec.gov/submissions/CIK{cik10}.json (looks up accession in the filings.recent block)

Args: cik: CIK (zero-padded or not). accession_number: SEC accession, dashed ("0000320193-25-000079") or undashed ("000032019325000079") — either works.

Returns dict with form, filing_date, report_date, acceptance_datetime, primary_document, primary_document_url, filing_index_url, is_xbrl, is_inline_xbrl, size_bytes, items (for 8-K), plus original_url = primary_document_url. If the accession predates the recent-1000 window, returns error="not_in_recent_1000" + older_file_pointers telling the agent where to look next. License: US Public Domain.

파라미터

이름타입설명
cik *string
accession_number *string
원본 JSON schema
{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    },
    "accession_number": {
      "title": "Accession Number",
      "type": "string"
    }
  },
  "required": [
    "cik",
    "accession_number"
  ],
  "title": "us_get_sec_filingArguments",
  "type": "object"
}

호출 방법

스타터 — 파라미터는 위 표 참조
us_get_sec_filing({ cik: "…" })