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: "…" })