Twinkle HubTwinkle Hub

美股 SEC 申報文件列表 (10-K/10-Q/8-K)

us_get_sec_filings

🇺🇸 アメリカ読み取り専用

關鍵字 / Keywords: SEC EDGAR 美股 申報 財報 10-K 10-Q 8-K DEF-14A Form-4 annual report quarterly current insider proxy filings list company CIK filing date

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

List a filer's recent filings, optionally filtered by form type and filing-date range.

Endpoint: https://data.sec.gov/submissions/CIK{cik10}.json (the filings.recent block · ~1000 most recent filings)

Args: cik: CIK (zero-padded or not) or "CIK…" form (e.g. "0000320193" for Apple, "0000789019" for Microsoft, "0001046179" for TSMC). form_types: filter to specific form(s) — common: "10-K" (annual report), "10-Q" (quarterly), "8-K" (current event), "DEF 14A" (proxy), "4" (insider transactions), "SC 13G" (5%+ holder). Case-insensitive. Pass None to include every form. date_from / date_to: YYYY-MM-DD filing-date bounds (inclusive). limit: max rows returned (default 40).

Returns dict with filings — each row has accession_number, form, filing_date, report_date, primary_document, primary_document_description, is_xbrl, is_inline_xbrl, original_url (direct link to the primary document on www.sec.gov/Archives), plus older_file_pointers for filings older than the recent 1000. License: US Public Domain.

パラメータ

名前説明
cik *string
form_typesarray
date_fromstring
date_tostring
limitinteger
生の JSON schema
{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    },
    "form_types": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Form Types"
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Date From"
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Date To"
    },
    "limit": {
      "default": 40,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "cik"
  ],
  "title": "us_get_sec_filingsArguments",
  "type": "object"
}

呼び出し方

スターター——パラメータは​上表参照
us_get_sec_filings({ cik: "…" })