リファレンス

API リファレンス

ベース URL · https://api.kakerapetit.dev

01 — 認証

認証

REST リクエストは、キーを X-API-Key ヘッダーに載せて認証します:

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/7203"

キーは /signup で無料登録するとアカウントページで発行されます — 無料枠は累計 100 コール(カード不要)。キーの表示は一度きりで、ローテーションや失効はアカウントページから行えます。

MCP サーバーでは同じキーを Bearer トークンとして使います: Authorization: Bearer kkp_...(MCP セクション参照)。

キーなしでも使えます — 有料エンドポイントはキーなしのリクエストに x402 支払いチャレンジで応答し、USDC でリクエスト単位の支払いができます(アカウント不要)。詳しくは /x402

02 — レート制限とクォータ

クォータとレート制限

無料プラン: 累計 100 コール。クォータはアカウント単位(アカウント内のすべての無料キーがカウンタを共有)で、リセットされません — 使い切ると以後のコールは 429 になります。スタンダードへのアップグレード、または X-API-Key ヘッダーを外して x402 の従量課金で継続してください。

スタンダードプラン: 累計クォータなし — フェアユースの制限のみ: キーごとに 100 リクエスト / 10 秒 のレート制限と、通常の利用では到達しない月間 1,000,000 コールの上限。プランはアカウント単位で、申し込むとアカウント内の既存キーがすべてそのままスタンダードに昇格し(再発行不要)、解約すると失効させずに無料へ戻します。新規申し込みには 7 日間の無料トライアルが付きます。超過したバーストには数秒の Retry-After 付き 429 を返します。間隔を空けて再試行してください。

03 — エラー

エラー形式とステータスコード

エラーはすべて JSON で、機械可読の error コードと、修正方法を示す message を返します:

HTTP/2 400
{
  "error": "invalid_request",
  "message": "unknown query parameter \"roe\" — allowed: sector, standard, market, limit, offset, <metric>_gte, <metric>_lte"
}
  • 400 invalid_request未知または不正なクエリパラメータは拒否され、message に受け付け可能なパラメータが列挙されます。
  • 401 invalid_api_keyX-API-Key ヘッダーはあるものの、有効なキーではありません。/signup で無料キーを取得するか、ヘッダーを外して従量課金にしてください。
  • 402 payment_required有料エンドポイントへのキーなしリクエスト — エラーではなく x402 の支払いチャレンジです。詳しくは /x402
  • 404 company_not_foundその {market}/{code} キーに該当する企業がありません(jp 以外の market は unknown_market)。
  • 429 lifetime_quota_exhausted無料アカウントの累計クォータを使い切りました。Retry-After は付きません — クォータはリセットされないためです。スタンダードにアップグレードするか、キーなしの x402 で継続してください。
  • 429 rate_limitedスタンダードキーがフェアユースを超過しました。一時的な制限です — Retry-After 秒後に再試行してください。
04 — エンドポイント

エンドポイント

企業キーは {market}/{code}(例: jp/7203 = トヨタ)。{market} は現在 jp(EDINET 掲載の国内上場企業)のみ対応です。すべて GET・JSON 返却で、レコードごとに出典(EDINET 書類 ID・提出日時)が付きます。

GET /v2/companies/:market/:code

日本の上場企業のプロフィールと最新のファンダメンタルズを、EDGAR 型の統一スキーマで返します。EDINET の有価証券報告書を英語の snake_case フィールドに正規化し、JPY サフィックスの代わりに currency タグを付与。セクター・決算期に加え、売上・営業利益・純利益・総資産・純資産・キャッシュフロー・設備投資・研究開発など 34 の財務指標、ROE・ROA・各種マージン・自己資本比率などの比率、従業員数・平均給与を含みます。

パスパラメータ

名前必須説明
marketstring (jp)Market segment. "jp" = Japan (EDINET). US (EDGAR) planned.
codestringCompany code within the market: for "jp" the securities code, e.g. "7203" (Toyota) or "130A".

リクエスト例

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/2212"
レスポンスフィールド
名前
company.marketstring"jp"
company.codestring"2212"
company.edinet_codestring"E00375"
company.namestring"山崎製パン株式会社"
company.name_enstring"YAMAZAKI BAKING CO., LTD."
company.sectorstring"食料品"
company.fiscal_year_endstring"12-31"
company.statusnullnull
filing.doc_idstring"S100XQ5C"
filing.typestring"annual_securities_report"
filing.period_startstring"2025-01-01"
filing.period_endstring"2025-12-31"
filing.filed_atstring"2026-03-24 15:00"
filing.standardstring"JGAAP"
filing.currencystring"JPY"
latest.period_endstring"2025-12-31"
latest.fiscal_yearstring"FY2025"
latest.period_startstring"2025-01-01"
latest.period_monthsnumber12
latest.consolidatedbooleantrue
latest.standardstring"JGAAP"
latest.currencystring"JPY"
latest.total_assetsnumber931878000000
latest.current_assetsnumber365470000000
latest.cash_and_depositsnumber163820000000
latest.trade_receivablesnumber149740000000
latest.inventoriesnumber35176000000
latest.ppenumber371564000000
latest.intangiblesnumber18112000000
latest.total_liabilitiesnumber421050000000
latest.current_liabilitiesnumber274156000000
latest.interest_bearing_debtnumber95432000000
latest.net_assetsnumber510828000000
latest.equity_ownersnumber459880000000
latest.treasury_sharesnumber-55517000000
latest.revenuenumber1311430000000
latest.cost_of_salesnumber883025000000
latest.gross_profitnumber428404000000
latest.sganumber367263000000
latest.operating_incomenumber61141000000
latest.ordinary_incomenumber64314000000
latest.pretax_incomenumber61569000000
latest.income_taxesnumber18111000000
latest.net_incomenumber43458000000
latest.net_income_ownersnumber40893000000
latest.eps_basicnumber206.78
latest.eps_dilutednullnull
latest.rnd_expensenumber9447000000
latest.cf_operatingnumber78870000000
latest.cf_investingnumber-55859000000
latest.cf_financingnumber-14126000000
latest.capexnumber-53294000000
latest.capex_disclosurenumber59942000000
latest.depreciationnumber43644000000
latest.dividends_paidnumber-8922000000
latest.cash_endnumber155423000000
latest.revenue_sourcestring"statement"
latest.roe_pctnumber8.89
latest.roa_pctnumber4.39
latest.operating_margin_pctnumber4.66
latest.net_margin_pctnumber3.12
latest.equity_ratio_pctnumber49.35
latest.current_ratio_pctnumber133.31
latest.de_rationumber0.2075
latest.asset_turnovernumber1.4073
latest.fcfnumber25576000000
latest.doc_idstring"S100XQ5C"
latest.filed_atstring"2026-03-24 15:00"
employees.consolidatednumber33545
employees.parentnumber19175
employees.average_annual_salarynullnull
employees.average_age_yearsnullnull
employees.average_tenure_yearsnullnull
employees.currencystring"JPY"
source.attributionstring"出典:EDINET閲覧(提出)サイト(https://disclosure2dl…
source.attribution_enstring"Source: EDINET, Financial Services Agenc…
source.doc_idstring"S100XQ5C"
source.filed_atstring"2026-03-24 15:00"

レスポンス例

{
  "company": {
    "market": "jp",
    "code": "2212",
    "edinet_code": "E00375",
    "name": "山崎製パン株式会社",
    "name_en": "YAMAZAKI BAKING CO., LTD.",
    "sector": "食料品",
    "fiscal_year_end": "12-31",
    "status": null
  },
  "filing": {
    "doc_id": "S100XQ5C",
    "type": "annual_securities_report",
    "period_start": "2025-01-01",
    "period_end": "2025-12-31",
    "filed_at": "2026-03-24 15:00",
    "standard": "JGAAP",
    "currency": "JPY"
  },
  "latest": {
    "period_end": "2025-12-31",
    "fiscal_year": "FY2025",
    "period_start": "2025-01-01",
    "period_months": 12,
    "consolidated": true,
    "standard": "JGAAP",
    "currency": "JPY",
    "total_assets": 931878000000,
    "current_assets": 365470000000,
    "cash_and_deposits": 163820000000,
    "trade_receivables": 149740000000,
    "inventories": 35176000000,
    "ppe": 371564000000,
    "intangibles": 18112000000,
    "total_liabilities": 421050000000,
    "current_liabilities": 274156000000,
    "interest_bearing_debt": 95432000000,
    "net_assets": 510828000000,
    "equity_owners": 459880000000,
    "treasury_shares": -55517000000,
    "revenue": 1311430000000,
    "cost_of_sales": 883025000000,
    "gross_profit": 428404000000,
    "sga": 367263000000,
    "operating_income": 61141000000,
    "ordinary_income": 64314000000,
    "pretax_income": 61569000000,
    "income_taxes": 18111000000,
    "net_income": 43458000000,
    "net_income_owners": 40893000000,
    "eps_basic": 206.78,
    "eps_diluted": null,
    "rnd_expense": 9447000000,
    "cf_operating": 78870000000,
    "cf_investing": -55859000000,
    "cf_financing": -14126000000,
    "capex": -53294000000,
    "capex_disclosure": 59942000000,
    "depreciation": 43644000000,
    "dividends_paid": -8922000000,
    "cash_end": 155423000000,
    "revenue_source": "statement",
    "roe_pct": 8.89,
    "roa_pct": 4.39,
    "operating_margin_pct": 4.66,
    "net_margin_pct": 3.12,
    "equity_ratio_pct": 49.35,
    "current_ratio_pct": 133.31,
    "de_ratio": 0.2075,
    "asset_turnover": 1.4073,
    "fcf": 25576000000,
    "doc_id": "S100XQ5C",
    "filed_at": "2026-03-24 15:00"
  },
  "employees": {
    "consolidated": 33545,
    "parent": 19175,
    "average_annual_salary": null,
    "average_age_years": null,
    "average_tenure_years": null,
    "currency": "JPY"
  },
  "source": {
    "attribution": "出典:EDINET閲覧(提出)サイト(https://disclosure2dl.edinet-fsa.go.jp/)、PDL1.0",
    "attribution_en": "Source: EDINET, Financial Services Agency of Japan (PDL 1.0). Processed and normalized by api.kakerapetit.dev.",
    "doc_id": "S100XQ5C",
    "filed_at": "2026-03-24 15:00"
  }
}

GET /v2/companies/:market/:code/financials

日本の上場企業の財務諸表の時系列を返します。EDINET の有価証券報告書から最大 10 期分の正規化済みファンダメンタルズを取得。各期に売上・売上総利益・営業利益・純利益・EPS・総資産・負債・純資産・キャッシュフロー・設備投資・研究開発・配当と、ROE・ROA・営業利益率・自己資本比率・D/E・FCF などの算出比率を含み、会計基準(JGAAP/IFRS/米国基準)を年ごとに明記します。

パスパラメータ

名前必須説明
marketstring (jp)Market segment. "jp" = Japan (EDINET). US (EDGAR) planned.
codestringCompany code within the market: for "jp" the securities code, e.g. "7203" (Toyota) or "130A".

クエリパラメータ

名前必須説明
yearsintegerNumber of fiscal years, newest first (default 6, max 10).

リクエスト例

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/2212/financials?years=6"
レスポンスフィールド
名前
company.marketstring"jp"
company.codestring"2212"
company.namestring"山崎製パン株式会社"
company.name_enstring"YAMAZAKI BAKING CO., LTD."
company.sectorstring"食料品"
countnumber2
years[]object[]
years[].period_endstring"2025-12-31"
years[].fiscal_yearstring"FY2025"
years[].period_startstring"2025-01-01"
years[].period_monthsnumber12
years[].consolidatedbooleantrue
years[].standardstring"JGAAP"
years[].currencystring"JPY"
years[].total_assetsnumber931878000000
years[].current_assetsnumber365470000000
years[].cash_and_depositsnumber163820000000
years[].trade_receivablesnumber149740000000
years[].inventoriesnumber35176000000
years[].ppenumber371564000000
years[].intangiblesnumber18112000000
years[].total_liabilitiesnumber421050000000
years[].current_liabilitiesnumber274156000000
years[].interest_bearing_debtnumber95432000000
years[].net_assetsnumber510828000000
years[].equity_ownersnumber459880000000
years[].treasury_sharesnumber-55517000000
years[].revenuenumber1311430000000
years[].cost_of_salesnumber883025000000
years[].gross_profitnumber428404000000
years[].sganumber367263000000
years[].operating_incomenumber61141000000
years[].ordinary_incomenumber64314000000
years[].pretax_incomenumber61569000000
years[].income_taxesnumber18111000000
years[].net_incomenumber43458000000
years[].net_income_ownersnumber40893000000
years[].eps_basicnumber206.78
years[].eps_dilutednullnull
years[].rnd_expensenumber9447000000
years[].cf_operatingnumber78870000000
years[].cf_investingnumber-55859000000
years[].cf_financingnumber-14126000000
years[].capexnumber-53294000000
years[].capex_disclosurenumber59942000000
years[].depreciationnumber43644000000
years[].dividends_paidnumber-8922000000
years[].cash_endnumber155423000000
years[].revenue_sourcestring"statement"
years[].roe_pctnumber8.89
years[].roa_pctnumber4.39
years[].operating_margin_pctnumber4.66
years[].net_margin_pctnumber3.12
years[].equity_ratio_pctnumber49.35
years[].current_ratio_pctnumber133.31
years[].de_rationumber0.2075
years[].asset_turnovernumber1.4073
years[].fcfnumber25576000000
years[].doc_idstring"S100XQ5C"
years[].filed_atstring"2026-03-24 15:00"
source.attributionstring"出典:EDINET閲覧(提出)サイト(https://disclosure2dl…
source.attribution_enstring"Source: EDINET, Financial Services Agenc…

レスポンス例

{
  "company": {
    "market": "jp",
    "code": "2212",
    "name": "山崎製パン株式会社",
    "name_en": "YAMAZAKI BAKING CO., LTD.",
    "sector": "食料品"
  },
  "count": 2,
  "years": [
    {
      "period_end": "2025-12-31",
      "fiscal_year": "FY2025",
      "period_start": "2025-01-01",
      "period_months": 12,
      "consolidated": true,
      "standard": "JGAAP",
      "currency": "JPY",
      "total_assets": 931878000000,
      "current_assets": 365470000000,
      "cash_and_deposits": 163820000000,
      "trade_receivables": 149740000000,
      "inventories": 35176000000,
      "ppe": 371564000000,
      "intangibles": 18112000000,
      "total_liabilities": 421050000000,
      "current_liabilities": 274156000000,
      "interest_bearing_debt": 95432000000,
      "net_assets": 510828000000,
      "equity_owners": 459880000000,
      "treasury_shares": -55517000000,
      "revenue": 1311430000000,
      "cost_of_sales": 883025000000,
      "gross_profit": 428404000000,
      "sga": 367263000000,
      "operating_income": 61141000000,
      "ordinary_income": 64314000000,
      "pretax_income": 61569000000,
      "income_taxes": 18111000000,
      "net_income": 43458000000,
      "net_income_owners": 40893000000,
      "eps_basic": 206.78,
      "eps_diluted": null,
      "rnd_expense": 9447000000,
      "cf_operating": 78870000000,
      "cf_investing": -55859000000,
      "cf_financing": -14126000000,
      "capex": -53294000000,
      "capex_disclosure": 59942000000,
      "depreciation": 43644000000,
      "dividends_paid": -8922000000,
      "cash_end": 155423000000,
      "revenue_source": "statement",
      "roe_pct": 8.89,
      "roa_pct": 4.39,
      "operating_margin_pct": 4.66,
      "net_margin_pct": 3.12,
      "equity_ratio_pct": 49.35,
      "current_ratio_pct": 133.31,
      "de_ratio": 0.2075,
      "asset_turnover": 1.4073,
      "fcf": 25576000000,
      "doc_id": "S100XQ5C",
      "filed_at": "2026-03-24 15:00"
    },
    {
      "period_end": "2024-12-31",
      "fiscal_year": "FY2024",
      "period_start": "2024-01-01",
      "period_months": 12,
      "consolidated": true,
      "standard": "JGAAP",
      "currency": "JPY",
      "total_assets": 865105000000,
      "current_assets": 341404000000,
      "cash_and_deposits": 152443000000,
      "trade_receivables": 141031000000,
      "inventories": 32647000000,
      "ppe": 358597000000,
      "intangibles": 19197000000,
      "total_liabilities": 404618000000,
      "current_liabilities": 269953000000,
      "interest_bearing_debt": 92675000000,
      "net_assets": 460486000000,
      "equity_owners": 412149000000,
      "treasury_shares": -51852000000,
      "revenue": 1244488000000,
      "cost_of_sales": 839233000000,
      "gross_profit": 405255000000,
      "sga": 353381000000,
      "operating_income": 51873000000,
      "ordinary_income": 56305000000,
      "pretax_income": 55636000000,
      "income_taxes": 17502000000,
      "net_income": 38133000000,
      "net_income_owners": 36015000000,
      "eps_basic": 178.58,
      "eps_diluted": null,
      "rnd_expense": null,
      "cf_operating": 73974000000,
      "cf_investing": -43492000000,
      "cf_financing": -15038000000,
      "capex": -45669000000,
      "capex_disclosure": null,
      "depreciation": 41863000000,
      "dividends_paid": -5136000000,
      "cash_end": 145939000000,
      "revenue_source": "statement",
      "roe_pct": 8.74,
      "roa_pct": 4.16,
      "operating_margin_pct": 4.17,
      "net_margin_pct": 2.89,
      "equity_ratio_pct": 47.64,
      "current_ratio_pct": 126.47,
      "de_ratio": 0.2249,
      "asset_turnover": 1.4385,
      "fcf": 28305000000,
      "doc_id": "S100XQ5C",
      "filed_at": "2026-03-24 15:00"
    }
  ],
  "source": {
    "attribution": "出典:EDINET閲覧(提出)サイト(https://disclosure2dl.edinet-fsa.go.jp/)、PDL1.0",
    "attribution_en": "Source: EDINET, Financial Services Agency of Japan (PDL 1.0). Processed and normalized by api.kakerapetit.dev."
  }
}

GET /v2/companies/:market/:code/governance

日本の上場企業のコーポレートガバナンス情報を、市場に依存しない統一スキーマで返します。役員区分別の報酬(固定・賞与・業績連動・株式報酬)、1 億円以上の個人別役員報酬、上位 10 位までの大株主と保有比率、政策保有株式(発行体・株式数・金額)を、最新の有価証券報告書から取得します。ガバナンス・スクリーニング、議決権行使や ESG リサーチ向け。

パスパラメータ

名前必須説明
marketstring (jp)Market segment. "jp" = Japan (EDINET). US (EDGAR) planned.
codestringCompany code within the market: for "jp" the securities code, e.g. "7203" (Toyota) or "130A".

リクエスト例

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/7203/governance"
レスポンスフィールド
名前
company.marketstring"jp"
company.codestring"7203"
company.edinet_codestring"E02144"
company.namestring"トヨタ自動車株式会社"
company.name_enstring"TOYOTA MOTOR CORPORATION"
company.sectorstring"輸送用機器"
company.fiscal_year_endstring"03-31"
company.statusnullnull
filing.doc_idstring"S100Y8NY"
filing.typestring"annual_securities_report"
filing.period_startstring"2025-04-01"
filing.period_endstring"2026-03-31"
filing.filed_atstring"2026-06-10 15:33"
filing.standardstring"IFRS"
filing.currencystring"JPY"
currencystring"JPY"
officer_remuneration.by_category[]object[]
officer_remuneration.by_category[].categorystring"MembersOfTheBoardOfDirectorsExclDirector…
officer_remuneration.by_category[].memberstring"jpcrp030000-asr_E02144-000MembersOfTheBo…
officer_remuneration.by_category[].is_extension_memberbooleantrue
officer_remuneration.by_category[].is_of_which_breakdownbooleanfalse
officer_remuneration.by_category[].totalnumber4131000000
officer_remuneration.by_category[].fixednumber932000000
officer_remuneration.by_category[].bonusnumber1206000000
officer_remuneration.by_category[].performance_basednullnull
officer_remuneration.by_category[].share_awardsnumber1993000000
officer_remuneration.by_category[].restricted_share_awardsnullnull
officer_remuneration.by_category[].non_monetarynullnull
officer_remuneration.by_category[].officer_countnumber12
officer_remuneration.individuals[]object[]
officer_remuneration.individuals[].namestring"豊 田 章 男"
officer_remuneration.individuals[].rolestring"取締役会長(代表取締役)"
officer_remuneration.individuals[].totalnumber2113000000
major_shareholders[]object[]
major_shareholders[].ranknumber1
major_shareholders[].namestring"日本マスタートラスト信託銀行㈱"
major_shareholders[].shares_heldnumber1667971000
major_shareholders[].ratio_pctnumber12.8
cross_shareholdings.listed_issue_countnumber34
cross_shareholdings.listed_carrying_amountnumber3237498000000
cross_shareholdings.unlisted_issue_countnumber80
cross_shareholdings.unlisted_carrying_amountnumber71851000000
cross_shareholdings.top[]object[]
cross_shareholdings.top[].issuerstring"KDDI㈱"
cross_shareholdings.top[].sharesnumber363365900
cross_shareholdings.top[].balance_sheet_valuenumber989627000000
cross_shareholdings.top[].purposestring"自動車関連(情報)取引の維持・発展[株式数が変動した理由]株式分割、一部売却のた…
source.attributionstring"出典:EDINET閲覧(提出)サイト(https://disclosure2dl…
source.attribution_enstring"Source: EDINET, Financial Services Agenc…
source.doc_idstring"S100Y8NY"
source.filed_atstring"2026-06-10 15:33"

レスポンス例

{
  "company": {
    "market": "jp",
    "code": "7203",
    "edinet_code": "E02144",
    "name": "トヨタ自動車株式会社",
    "name_en": "TOYOTA MOTOR CORPORATION",
    "sector": "輸送用機器",
    "fiscal_year_end": "03-31",
    "status": null
  },
  "filing": {
    "doc_id": "S100Y8NY",
    "type": "annual_securities_report",
    "period_start": "2025-04-01",
    "period_end": "2026-03-31",
    "filed_at": "2026-06-10 15:33",
    "standard": "IFRS",
    "currency": "JPY"
  },
  "currency": "JPY",
  "officer_remuneration": {
    "by_category": [
      {
        "category": "MembersOfTheBoardOfDirectorsExclDirectorsWhoAreAuditAndSupervisoryCommitteeMembers",
        "member": "jpcrp030000-asr_E02144-000MembersOfTheBoardOfDirectorsExclDirectorsWhoAreAuditAndSupervisoryCommitteeMembersMember",
        "is_extension_member": true,
        "is_of_which_breakdown": false,
        "total": 4131000000,
        "fixed": 932000000,
        "bonus": 1206000000,
        "performance_based": null,
        "share_awards": 1993000000,
        "restricted_share_awards": null,
        "non_monetary": null,
        "officer_count": 12
      },
      {
        "category": "社外監査役",
        "member": "OutsideCorporateAuditorsMember",
        "is_extension_member": false,
        "is_of_which_breakdown": false,
        "total": 28000000,
        "fixed": 28000000,
        "bonus": null,
        "performance_based": null,
        "share_awards": null,
        "restricted_share_awards": null,
        "non_monetary": null,
        "officer_count": 3
      }
    ],
    "individuals": [
      {
        "name": "豊  田  章  男",
        "role": "取締役会長(代表取締役)",
        "total": 2113000000
      },
      {
        "name": "佐  藤  恒  治",
        "role": "取締役副会長(代表取締役)",
        "total": 803000000
      }
    ]
  },
  "major_shareholders": [
    {
      "rank": 1,
      "name": "日本マスタートラスト信託銀行㈱",
      "shares_held": 1667971000,
      "ratio_pct": 12.8
    },
    {
      "rank": 2,
      "name": "㈱豊田自動織機",
      "shares_held": 1192331000,
      "ratio_pct": 9.15
    },
    {
      "rank": 3,
      "name": "㈱日本カストディ銀行",
      "shares_held": 794894000,
      "ratio_pct": 6.1
    }
  ],
  "cross_shareholdings": {
    "listed_issue_count": 34,
    "listed_carrying_amount": 3237498000000,
    "unlisted_issue_count": 80,
    "unlisted_carrying_amount": 71851000000,
    "top": [
      {
        "issuer": "KDDI㈱",
        "shares": 363365900,
        "balance_sheet_value": 989627000000,
        "purpose": "自動車関連(情報)取引の維持・発展[株式数が変動した理由]株式分割、一部売却のため"
      },
      {
        "issuer": "NTT㈱",
        "shares": 2019385000,
        "balance_sheet_value": 317447000000,
        "purpose": "自動車関連(情報)取引の維持・発展"
      }
    ]
  },
  "source": {
    "attribution": "出典:EDINET閲覧(提出)サイト(https://disclosure2dl.edinet-fsa.go.jp/)、PDL1.0",
    "attribution_en": "Source: EDINET, Financial Services Agency of Japan (PDL 1.0). Processed and normalized by api.kakerapetit.dev.",
    "doc_id": "S100Y8NY",
    "filed_at": "2026-06-10 15:33"
  }
}

GET /v2/screener

日本の上場企業を、EDINET の有価証券報告書のファンダメンタルズでスクリーニングします。40 以上の正規化指標を _gte/_lte クエリで絞り込み — 売上・営業利益・純利益・総資産・roe・roa・営業利益率・自己資本比率(比率は%指定)— に加え、セクターや会計基準(JGAAP/IFRS/USGAAP)でもフィルタできます。各社の最新会計年度を全指標・全比率付きで返します。

クエリパラメータ

名前必須説明
roe_gtenumberExample metric filter: ROE >= value in percent. Any indicator or ratio column works with a _gte/_lte suffix (revenue_gte, operating_margin_gte, equity_ratio_gte, total_assets_lte, …); ratio thresholds are percent, money thresholds are currency units.
revenue_gtenumberExample metric filter: revenue >= value in JPY.
sectorstringEDINET sector label, e.g. 輸送用機器 (transport equipment).
standardstring (JGAAP | IFRS | USGAAP)Accounting standard.
marketstring (jp)Market segment (default: all; only jp today).
limitintegerMax rows (default 50, max 100).
offsetintegerPagination offset.
ランキング・絞り込みに使える指標(43個)

total_assets, current_assets, cash_and_deposits, trade_receivables, inventories, ppe, intangibles, total_liabilities, current_liabilities, interest_bearing_debt, net_assets, equity_owners, treasury_shares, revenue, cost_of_sales, gross_profit, sga, operating_income, ordinary_income, pretax_income, income_taxes, net_income, net_income_owners, eps_basic, eps_diluted, rnd_expense, cf_operating, cf_investing, cf_financing, capex, capex_disclosure, depreciation, dividends_paid, cash_end, roe, roa, operating_margin, net_margin, equity_ratio, current_ratio, de_ratio, asset_turnover, fcf

リクエスト例

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/screener?roe_gte=5&revenue_gte=100000000000&limit=1"
レスポンスフィールド
名前
countnumber1
limitnumber1
offsetnumber0
results[]object[]
results[].marketstring"jp"
results[].codestring"2212"
results[].namestring"山崎製パン株式会社"
results[].name_enstring"YAMAZAKI BAKING CO., LTD."
results[].sectorstring"食料品"
results[].period_endstring"2025-12-31"
results[].fiscal_yearstring"FY2025"
results[].period_startstring"2025-01-01"
results[].period_monthsnumber12
results[].consolidatedbooleantrue
results[].standardstring"JGAAP"
results[].currencystring"JPY"
results[].total_assetsnumber931878000000
results[].current_assetsnumber365470000000
results[].cash_and_depositsnumber163820000000
results[].trade_receivablesnumber149740000000
results[].inventoriesnumber35176000000
results[].ppenumber371564000000
results[].intangiblesnumber18112000000
results[].total_liabilitiesnumber421050000000
results[].current_liabilitiesnumber274156000000
results[].interest_bearing_debtnumber95432000000
results[].net_assetsnumber510828000000
results[].equity_ownersnumber459880000000
results[].treasury_sharesnumber-55517000000
results[].revenuenumber1311430000000
results[].cost_of_salesnumber883025000000
results[].gross_profitnumber428404000000
results[].sganumber367263000000
results[].operating_incomenumber61141000000
results[].ordinary_incomenumber64314000000
results[].pretax_incomenumber61569000000
results[].income_taxesnumber18111000000
results[].net_incomenumber43458000000
results[].net_income_ownersnumber40893000000
results[].eps_basicnumber206.78
results[].eps_dilutednullnull
results[].rnd_expensenumber9447000000
results[].cf_operatingnumber78870000000
results[].cf_investingnumber-55859000000
results[].cf_financingnumber-14126000000
results[].capexnumber-53294000000
results[].capex_disclosurenumber59942000000
results[].depreciationnumber43644000000
results[].dividends_paidnumber-8922000000
results[].cash_endnumber155423000000
results[].revenue_sourcestring"statement"
results[].roe_pctnumber8.89
results[].roa_pctnumber4.39
results[].operating_margin_pctnumber4.66
results[].net_margin_pctnumber3.12
results[].equity_ratio_pctnumber49.35
results[].current_ratio_pctnumber133.31
results[].de_rationumber0.2075
results[].asset_turnovernumber1.4073
results[].fcfnumber25576000000
results[].doc_idstring"S100XQ5C"
results[].filed_atstring"2026-03-24 15:00"
source.attributionstring"出典:EDINET閲覧(提出)サイト(https://disclosure2dl…
source.attribution_enstring"Source: EDINET, Financial Services Agenc…

レスポンス例

{
  "count": 1,
  "limit": 1,
  "offset": 0,
  "results": [
    {
      "market": "jp",
      "code": "2212",
      "name": "山崎製パン株式会社",
      "name_en": "YAMAZAKI BAKING CO., LTD.",
      "sector": "食料品",
      "period_end": "2025-12-31",
      "fiscal_year": "FY2025",
      "period_start": "2025-01-01",
      "period_months": 12,
      "consolidated": true,
      "standard": "JGAAP",
      "currency": "JPY",
      "total_assets": 931878000000,
      "current_assets": 365470000000,
      "cash_and_deposits": 163820000000,
      "trade_receivables": 149740000000,
      "inventories": 35176000000,
      "ppe": 371564000000,
      "intangibles": 18112000000,
      "total_liabilities": 421050000000,
      "current_liabilities": 274156000000,
      "interest_bearing_debt": 95432000000,
      "net_assets": 510828000000,
      "equity_owners": 459880000000,
      "treasury_shares": -55517000000,
      "revenue": 1311430000000,
      "cost_of_sales": 883025000000,
      "gross_profit": 428404000000,
      "sga": 367263000000,
      "operating_income": 61141000000,
      "ordinary_income": 64314000000,
      "pretax_income": 61569000000,
      "income_taxes": 18111000000,
      "net_income": 43458000000,
      "net_income_owners": 40893000000,
      "eps_basic": 206.78,
      "eps_diluted": null,
      "rnd_expense": 9447000000,
      "cf_operating": 78870000000,
      "cf_investing": -55859000000,
      "cf_financing": -14126000000,
      "capex": -53294000000,
      "capex_disclosure": 59942000000,
      "depreciation": 43644000000,
      "dividends_paid": -8922000000,
      "cash_end": 155423000000,
      "revenue_source": "statement",
      "roe_pct": 8.89,
      "roa_pct": 4.39,
      "operating_margin_pct": 4.66,
      "net_margin_pct": 3.12,
      "equity_ratio_pct": 49.35,
      "current_ratio_pct": 133.31,
      "de_ratio": 0.2075,
      "asset_turnover": 1.4073,
      "fcf": 25576000000,
      "doc_id": "S100XQ5C",
      "filed_at": "2026-03-24 15:00"
    }
  ],
  "source": {
    "attribution": "出典:EDINET閲覧(提出)サイト(https://disclosure2dl.edinet-fsa.go.jp/)、PDL1.0",
    "attribution_en": "Source: EDINET, Financial Services Agency of Japan (PDL 1.0). Processed and normalized by api.kakerapetit.dev."
  }
}

GET /v2/rankings

日本の上場企業を任意の財務指標でランク付けします。EDINET の有価証券報告書から roe・roa・売上・営業利益・純利益・総資産・自己資本比率・FCF など 30 以上の指標に対応。最新会計年度で上位/下位 N 社を、正規化済みの全指標行と届出の出典付きで返します。エージェント向けのリーグテーブルとファクタースクリーン。

クエリパラメータ

名前必須説明
metricstringMetric column to rank by (whitelisted): any indicator (revenue, total_assets, …) or ratio (roe, roa, operating_margin, equity_ratio, de_ratio, asset_turnover, fcf).
orderstring (desc | asc)Sort direction (default "desc").
limitintegerMax rows (default 50, max 100).
marketstring (jp)Market segment (default: all; only jp today).
ランキング・絞り込みに使える指標(43個)

total_assets, current_assets, cash_and_deposits, trade_receivables, inventories, ppe, intangibles, total_liabilities, current_liabilities, interest_bearing_debt, net_assets, equity_owners, treasury_shares, revenue, cost_of_sales, gross_profit, sga, operating_income, ordinary_income, pretax_income, income_taxes, net_income, net_income_owners, eps_basic, eps_diluted, rnd_expense, cf_operating, cf_investing, cf_financing, capex, capex_disclosure, depreciation, dividends_paid, cash_end, roe, roa, operating_margin, net_margin, equity_ratio, current_ratio, de_ratio, asset_turnover, fcf

リクエスト例

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/rankings?metric=roe&order=desc&limit=2"
レスポンスフィールド
名前
metricstring"roe"
orderstring"desc"
countnumber2
results[]object[]
results[].ranknumber1
results[].marketstring"jp"
results[].codestring"7751"
results[].namestring"キヤノン株式会社"
results[].name_enstring"CANON INC."
results[].sectorstring"電気機器"
results[].period_endstring"2025-12-31"
results[].fiscal_yearstring"FY2025"
results[].period_startstring"2025-01-01"
results[].period_monthsnumber12
results[].consolidatedbooleantrue
results[].standardstring"USGAAP"
results[].currencystring"JPY"
results[].total_assetsnumber6135044000000
results[].current_assetsnullnull
results[].cash_and_depositsnullnull
results[].trade_receivablesnullnull
results[].inventoriesnullnull
results[].ppenullnull
results[].intangiblesnullnull
results[].total_liabilitiesnullnull
results[].current_liabilitiesnullnull
results[].interest_bearing_debtnullnull
results[].net_assetsnumber3491808000000
results[].equity_ownersnumber3491808000000
results[].treasury_sharesnullnull
results[].revenuenumber4624727000000
results[].cost_of_salesnullnull
results[].gross_profitnullnull
results[].sganullnull
results[].operating_incomenullnull
results[].ordinary_incomenullnull
results[].pretax_incomenumber482059000000
results[].income_taxesnullnull
results[].net_incomenullnull
results[].net_income_ownersnumber332053000000
results[].eps_basicnumber367.48
results[].eps_dilutednumber367.25
results[].rnd_expensenumber339288000000
results[].cf_operatingnumber475903000000
results[].cf_investingnumber-237450000000
results[].cf_financingnumber-179221000000
results[].capexnullnull
results[].capex_disclosurenumber211673000000
results[].depreciationnullnull
results[].dividends_paidnullnull
results[].cash_endnumber585981000000
results[].revenue_sourcestring"standard"
results[].roe_pctnumber9.51
results[].roa_pctnumber5.41
results[].operating_margin_pctnullnull
results[].net_margin_pctnumber7.18
results[].equity_ratio_pctnumber56.92
results[].current_ratio_pctnullnull
results[].de_rationullnull
results[].asset_turnovernumber0.7538
results[].fcfnullnull
results[].doc_idstring"S100XTLJ"
results[].filed_atstring"2026-03-25 15:00"
source.attributionstring"出典:EDINET閲覧(提出)サイト(https://disclosure2dl…
source.attribution_enstring"Source: EDINET, Financial Services Agenc…

レスポンス例

{
  "metric": "roe",
  "order": "desc",
  "count": 2,
  "results": [
    {
      "rank": 1,
      "market": "jp",
      "code": "7751",
      "name": "キヤノン株式会社",
      "name_en": "CANON INC.",
      "sector": "電気機器",
      "period_end": "2025-12-31",
      "fiscal_year": "FY2025",
      "period_start": "2025-01-01",
      "period_months": 12,
      "consolidated": true,
      "standard": "USGAAP",
      "currency": "JPY",
      "total_assets": 6135044000000,
      "current_assets": null,
      "cash_and_deposits": null,
      "trade_receivables": null,
      "inventories": null,
      "ppe": null,
      "intangibles": null,
      "total_liabilities": null,
      "current_liabilities": null,
      "interest_bearing_debt": null,
      "net_assets": 3491808000000,
      "equity_owners": 3491808000000,
      "treasury_shares": null,
      "revenue": 4624727000000,
      "cost_of_sales": null,
      "gross_profit": null,
      "sga": null,
      "operating_income": null,
      "ordinary_income": null,
      "pretax_income": 482059000000,
      "income_taxes": null,
      "net_income": null,
      "net_income_owners": 332053000000,
      "eps_basic": 367.48,
      "eps_diluted": 367.25,
      "rnd_expense": 339288000000,
      "cf_operating": 475903000000,
      "cf_investing": -237450000000,
      "cf_financing": -179221000000,
      "capex": null,
      "capex_disclosure": 211673000000,
      "depreciation": null,
      "dividends_paid": null,
      "cash_end": 585981000000,
      "revenue_source": "standard",
      "roe_pct": 9.51,
      "roa_pct": 5.41,
      "operating_margin_pct": null,
      "net_margin_pct": 7.18,
      "equity_ratio_pct": 56.92,
      "current_ratio_pct": null,
      "de_ratio": null,
      "asset_turnover": 0.7538,
      "fcf": null,
      "doc_id": "S100XTLJ",
      "filed_at": "2026-03-25 15:00"
    },
    {
      "rank": 2,
      "market": "jp",
      "code": "5108",
      "name": "株式会社ブリヂストン",
      "name_en": "BRIDGESTONE CORPORATION",
      "sector": "ゴム製品",
      "period_end": "2025-12-31",
      "fiscal_year": "FY2025",
      "period_start": "2025-01-01",
      "period_months": 12,
      "consolidated": true,
      "standard": "IFRS",
      "currency": "JPY",
      "total_assets": 5747705000000,
      "current_assets": 2863182000000,
      "cash_and_deposits": 713810000000,
      "trade_receivables": 1093109000000,
      "inventories": 885458000000,
      "ppe": 1858259000000,
      "intangibles": 369355000000,
      "total_liabilities": 2027817000000,
      "current_liabilities": 1122654000000,
      "interest_bearing_debt": 487270000000,
      "net_assets": 3719888000000,
      "equity_owners": 3661793000000,
      "treasury_shares": -433930000000,
      "revenue": 4429452000000,
      "cost_of_sales": 2722789000000,
      "gross_profit": 1706663000000,
      "sga": 1219078000000,
      "operating_income": 381237000000,
      "ordinary_income": null,
      "pretax_income": 354661000000,
      "income_taxes": 30519000000,
      "net_income": 334299000000,
      "net_income_owners": 327264000000,
      "eps_basic": 246,
      "eps_diluted": 245.77,
      "rnd_expense": 126400000000,
      "cf_operating": 660442000000,
      "cf_investing": -224968000000,
      "cf_financing": -429902000000,
      "capex": -287155000000,
      "capex_disclosure": 365900000000,
      "depreciation": 353229000000,
      "dividends_paid": -148573000000,
      "cash_end": 713810000000,
      "revenue_source": "statement",
      "roe_pct": 8.94,
      "roa_pct": 5.69,
      "operating_margin_pct": 8.61,
      "net_margin_pct": 7.39,
      "equity_ratio_pct": 63.71,
      "current_ratio_pct": 255.04,
      "de_ratio": 0.1331,
      "asset_turnover": 0.7706,
      "fcf": 373287000000,
      "doc_id": "S100XRPR",
      "filed_at": "2026-03-18 15:00"
    }
  ],
  "source": {
    "attribution": "出典:EDINET閲覧(提出)サイト(https://disclosure2dl.edinet-fsa.go.jp/)、PDL1.0",
    "attribution_en": "Source: EDINET, Financial Services Agency of Japan (PDL 1.0). Processed and normalized by api.kakerapetit.dev."
  }
}

GET /v2/calendar

EDINET の提出カレンダー: 指定期間に日本の上場企業が提出した有価証券報告書を返します。企業コード・EDINET 書類 ID・対象期間・会計基準(JGAAP/IFRS/USGAAP)・正確な提出日時を各報告書について取得でき、新規開示の追跡やデータパイプラインのトリガー、直近に決算を出した銘柄の把握に使えます(1 リクエスト最大 92 日)。

クエリパラメータ

名前必須説明
fromstringRange start, ISO date (inclusive, filing date).
tostringRange end, ISO date (inclusive, max 92 days after from).
marketstring (jp)Market segment (default: all; only jp today).

リクエスト例

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/calendar?from=2026-06-20&to=2026-06-30"
レスポンスフィールド
名前
fromstring"2026-06-20"
tostring"2026-06-30"
countnumber2
filings[]object[]
filings[].marketstring"jp"
filings[].codestring"8334"
filings[].doc_idstring"S100Y8O1"
filings[].typestring"annual_securities_report"
filings[].period_startstring"2025-04-01"
filings[].period_endstring"2026-03-31"
filings[].filed_atstring"2026-06-20 15:00"
filings[].standardstring"JGAAP"
filings[].currencystring"JPY"
source.attributionstring"出典:EDINET閲覧(提出)サイト(https://disclosure2dl…
source.attribution_enstring"Source: EDINET, Financial Services Agenc…

レスポンス例

{
  "from": "2026-06-20",
  "to": "2026-06-30",
  "count": 2,
  "filings": [
    {
      "market": "jp",
      "code": "8334",
      "doc_id": "S100Y8O1",
      "type": "annual_securities_report",
      "period_start": "2025-04-01",
      "period_end": "2026-03-31",
      "filed_at": "2026-06-20 15:00",
      "standard": "JGAAP",
      "currency": "JPY"
    },
    {
      "market": "jp",
      "code": "7974",
      "doc_id": "S100Y9NX",
      "type": "annual_securities_report",
      "period_start": "2025-04-01",
      "period_end": "2026-03-31",
      "filed_at": "2026-06-25 15:30",
      "standard": "JGAAP",
      "currency": "JPY"
    }
  ],
  "source": {
    "attribution": "出典:EDINET閲覧(提出)サイト(https://disclosure2dl.edinet-fsa.go.jp/)、PDL1.0",
    "attribution_en": "Source: EDINET, Financial Services Agency of Japan (PDL 1.0). Processed and normalized by api.kakerapetit.dev."
  }
}
05 — MCP

MCP サーバー

任意の MCP クライアントを https://api.kakerapetit.dev/mcp(ストリーミング HTTP)に接続すると、REST エンドポイントとキーのクォータ・レート制限を共有する 6 つのツールが使えます。認証は Authorization: Bearer kkp_... です。

Claude Code

claude mcp add --transport http jp-fundamentals https://api.kakerapetit.dev/mcp \
  --header "Authorization: Bearer kkp_..."

claude.ai / Claude Desktop

設定 → コネクタ → カスタムコネクタを追加 → URL https://api.kakerapetit.dev/mcp。認証を求められたら Authorization: Bearer kkp_... を指定します。

Cursor・Windsurf などのクライアント

mcpServers 設定を読むクライアントは、ストリーミング HTTP サーバーを直接指定できます:

{
  "mcpServers": {
    "jp-fundamentals": {
      "url": "https://api.kakerapetit.dev/mcp",
      "headers": { "Authorization": "Bearer kkp_..." }
    }
  }
}

ChatGPT

ChatGPT(Plus・Pro・Team・Enterprise)では、設定 → コネクタ → 詳細設定 → デベロッパーモードを有効化し、「作成」から MCP サーバー URL https://api.kakerapetit.dev/mcpAuthorization: Bearer kkp_... ヘッダーを指定します。チャットには + → デベロッパーモードから追加します。

OpenAI Responses API では mcp ツールとして渡します:

{
  "type": "mcp",
  "server_url": "https://api.kakerapetit.dev/mcp",
  "authorization": "kkp_...",
  "require_approval": "never"
}

その他の MCP クライアント

URL:    https://api.kakerapetit.dev/mcp
Header: Authorization: Bearer kkp_...

認証は Bearer トークンとしての静的 API キーです(OAuth は未対応)。