Twinkle HubTwinkle Hub
로그인

美股 SEC XBRL 單一概念時序 (季/年)

us_get_sec_concept_series

🇺🇸 미국읽기 전용

關鍵字 / Keywords: SEC EDGAR XBRL concept time series us-gaap Revenues NetIncomeLoss Assets quarterly annual 季報 年報 financial ratio time series 財務比率 時間序列

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

One XBRL concept across all reported periods for one filer — the efficient path when you already know which line item you want (e.g. quarterly revenue history).

Endpoint: https://data.sec.gov/api/xbrl/companyconcept/CIK{cik10}/{taxonomy}/{tag}.json

Args: cik: CIK (zero-padded or not). taxonomy: usually "us-gaap" (US filers). Others: "dei" (entity registration), "ifrs-full" (foreign filers using IFRS), "srt" (SEC Reporting Taxonomy). tag: XBRL concept name. Common us-gaap tags: - "Revenues" · "SalesRevenueNet" · "RevenueFromContractWithCustomerExcludingAssessedTax" - "NetIncomeLoss" · "OperatingIncomeLoss" - "Assets" · "AssetsCurrent" · "Liabilities" · "StockholdersEquity" - "CashAndCashEquivalentsAtCarryingValue" If the tag is not reported, response has error="concept_not_reported" — call us_get_sec_company_facts to enumerate available tags.

Returns dict with label, description, unit_summary ({USD: n_periods, shares: n, …}), and units (raw per-period array). Each period row has end (period-end YYYY-MM-DD), val (numeric), accn (accession that reported it), fy, fp (Q1/Q2/Q3/FY), form (10-K / 10-Q), filed (filing date), optional frame (SEC quarter frame). License: US Public Domain.

파라미터

이름타입설명
cik *string—
taxonomystring—
tagstring—
원본 JSON schema
{
  "properties": {
    "cik": {
      "title": "Cik",
      "type": "string"
    },
    "taxonomy": {
      "default": "us-gaap",
      "title": "Taxonomy",
      "type": "string"
    },
    "tag": {
      "default": "Revenues",
      "title": "Tag",
      "type": "string"
    }
  },
  "required": [
    "cik"
  ],
  "title": "us_get_sec_concept_seriesArguments",
  "type": "object"
}

호출 방법

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