Reference

API Reference

Base URL · https://api.kakerapetit.dev

01 — Authentication

Authentication

Every REST request authenticates with your key in the X-API-Key header:

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

Keys are issued on your account page after a free sign-up at /signup — the free tier includes 100 calls (lifetime, no card). The key is shown once; you can rotate or revoke it on the account page.

The MCP server uses the same key as a bearer token instead: Authorization: Bearer kkp_... (see the MCP section).

Keyless access: every paid endpoint answers a keyless request with an x402 payment challenge — pay per call in USDC, no account. See /x402.

02 — Rate limits & quotas

Quotas and rate limits

Free plan: 100 calls, lifetime. The quota is account-wide (every free key on the account shares the counter) and never resets — once spent, every call returns 429 until you upgrade to Standard or drop the X-API-Key header to pay per call via x402.

Standard plan: no quota — a fair-use rate limit of 100 requests / 10s per key. The plan is account-wide: subscribing lifts every existing key on the account to Standard in place (no re-issue), and cancelling drops them back to free without revoking them. Bursts above the rate get 429 with a Retry-After of a few seconds; back off and retry.

03 — Errors

Error format and status codes

Every error is JSON with a machine-readable error code and a message describing how to fix the request:

HTTP/2 400
{
  "error": "invalid_request",
  "message": "unknown query parameter \"roe\" — allowed: sector, standard, market, limit, offset, <metric>_gte, <metric>_lte"
}
  • 400 invalid_requestUnknown or malformed query parameters are rejected; message lists the parameters the endpoint accepts.
  • 401 invalid_api_keyThe X-API-Key header is present but not a valid active key. Get a free key at /signup, or drop the header to pay per call.
  • 402 payment_requiredA keyless request to a paid endpoint — not an error but the x402 payment challenge. See /x402.
  • 404 company_not_foundNo company under that {market}/{code} key (also unknown_market for a market other than jp).
  • 429 lifetime_quota_exhaustedThe free account's lifetime quota is spent. No Retry-After — it never resets. Upgrade to Standard or continue keyless via x402.
  • 429 rate_limitedA Standard key burst above the fair-use rate. Transient — retry after the Retry-After seconds.
04 — Endpoints

Endpoints

The company key is {market}/{code}, e.g. jp/7203 (Toyota) — {market} currently accepts only jp (Japan-listed issuers from EDINET). All endpoints are GET, return JSON, and carry per-record provenance (EDINET document ID and filing timestamp).

GET /v2/companies/:market/:code

Company profile and latest fundamentals for a Japanese listed company in an EDGAR-style unified schema. Data from annual securities reports filed with EDINET (Japan FSA), normalized to English snake_case fields with a currency tag instead of JPY suffixes. Returns sector, fiscal year end, 34 financial indicators (revenue, operating income, net income, total assets, equity, cash flows, capex, R&D), ratios (ROE, ROA, margins, equity ratio) and employee headcount and average salary.

Path parameters

NameTypeRequiredDescription
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".

Example request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/2212"
Response fields
NameTypeExample
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"

Example response

{
  "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

Financial statement time series for a Japanese listed company: up to 10 fiscal years of normalized fundamentals from EDINET annual securities reports. Per year: revenue, gross profit, operating income, net income, EPS, total assets, liabilities, equity, cash flows, capex, R&D, dividends, and derived ratios — ROE, ROA, operating margin, equity ratio, D/E, FCF. Accounting standard (JGAAP/IFRS/US GAAP) marked per year. EDGAR-style unified schema for Japan stock fundamentals.

Path parameters

NameTypeRequiredDescription
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".

Query parameters

NameTypeRequiredDescription
yearsintegerNumber of fiscal years, newest first (default 6, max 10).

Example request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/2212/financials?years=6"
Response fields
NameTypeExample
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…

Example response

{
  "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

Corporate governance data for a Japanese listed company in a unified market-agnostic schema: executive compensation by officer category (fixed, bonus, performance-based, stock awards), individual director pay over 100 million yen, top-10 major shareholders with ownership ratios, and cross-shareholdings (policy-held stocks) with issuer, shares and value. From the latest annual securities report filed with EDINET, Japan FSA. For governance screening, proxy and ESG research.

Path parameters

NameTypeRequiredDescription
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".

Example request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/7203/governance"
Response fields
NameTypeExample
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"

Example response

{
  "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

Screen Japanese listed companies by fundamentals from EDINET annual reports. Filter any of 40+ normalized metrics with _gte/_lte query params — revenue, operating income, net income, total assets, roe, roa, operating_margin, equity_ratio (ratio thresholds in percent) — plus sector and accounting standard (JGAAP/IFRS/USGAAP). Returns the latest fiscal year per company with all indicators and ratios. Example: /v2/screener?roe_gte=8&revenue_gte=100000000000. Japan stock screener for agents.

Query parameters

NameTypeRequiredDescription
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.
Rankable / filterable metrics (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

Example request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/screener?roe_gte=5&revenue_gte=100000000000&limit=1"
Response fields
NameTypeExample
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…

Example response

{
  "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

Rank Japanese listed companies by any financial metric from EDINET annual reports: roe, roa, revenue, operating_income, net_income, total_assets, equity_ratio, fcf and 30+ more. Returns the top or bottom N companies on the latest fiscal year, each with the full normalized indicator row and filing provenance. Example: /v2/rankings?metric=roe&order=desc&limit=10. League tables and factor screens for Japanese stocks in an EDGAR-style unified schema.

Query parameters

NameTypeRequiredDescription
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).
Rankable / filterable metrics (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

Example request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/rankings?metric=roe&order=desc&limit=2"
Response fields
NameTypeExample
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…

Example response

{
  "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 filing calendar: annual securities reports (yukashoken hokokusho) filed by Japanese listed companies in a date range. Returns company code, EDINET document ID, fiscal period, accounting standard (JGAAP/IFRS/USGAAP) and the exact filing timestamp for each report — track new disclosures, trigger data pipelines, or find which Japanese stocks just reported. Query: /v2/calendar?from=2026-06-20&to=2026-06-30 (max 92 days per request).

Query parameters

NameTypeRequiredDescription
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).

Example request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/calendar?from=2026-06-20&to=2026-06-30"
Response fields
NameTypeExample
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…

Example response

{
  "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 server

Connect any MCP client to https://api.kakerapetit.dev/mcp (streamable HTTP) — six tools sharing your key's quota and rate limit with the REST endpoints. Authenticate with 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

Settings → Connectors → Add custom connector → URL https://api.kakerapetit.dev/mcp. When asked for authentication, supply Authorization: Bearer kkp_....

Cursor, Windsurf & other clients

Clients that read an mcpServers config accept a streamable-HTTP server directly:

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

ChatGPT

In ChatGPT (Plus, Pro, Team or Enterprise): Settings → Connectors → Advanced → turn on Developer mode, then Create with the MCP server URL https://api.kakerapetit.dev/mcp and an Authorization: Bearer kkp_... header. Add it to a chat from the + → Developer mode menu.

Via the OpenAI Responses API, pass it as an mcp tool:

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

Any other MCP client

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

Authentication is a static API key as a bearer token (OAuth is not supported yet).