EDINET annual reports → structured, agent-ready data

Fundamentals for 3,900+
listed Japanese companies.

Annual securities reports from EDINET, resolved into one normalized JSON schema — derived ratios and per-record provenance included.

Get free API keyRead the docs

No card required · 100 calls free

SOURCE → NORMALIZEDTOYOTA MOTOR CORPORATIONjp / 7203 · IFRS · FY2025
revenue¥50.68T
net income
¥3.85T
ROE
10.1%
employees
390,927

GET /v2/companies/jp/7203 · source EDINET S100Y8NY

SnapshotScreenerRankingsCalendar
Run it →
3,900+reporting companies
~6,400annual reports
34 × 10metrics × fiscal years (schema max)
hourlyEDINET sync

Source: EDINET (Financial Services Agency of Japan) · PDL 1.0

01 — What you get

EDINET is free, but raw. This is the normalized product.

EDINET publishes every filing as XBRL — thousands of taxonomy tags, JGAAP/IFRS/US GAAP variants, Japanese labels. We resolve all of that into one clean, market-agnostic schema so an agent (or you) can query fundamentals directly.

/companies

One normalized schema

53 snake_case fields per fiscal year, resolved from thousands of XBRL taxonomy tags — English field names, English company names, market-agnostic jp/{code} keys. Values stay as filed (sector labels are EDINET's Japanese terms).

/screener

Screener & rankings

Filter 40+ indicators and ratios with _gte/_lte, or rank every company by any metric. Cross-company queries EDINET can't answer.

/financials

Time series

Up to 10 fiscal years stitched across filings (coverage is expanding — currently the most recent few years), each with derived ratios (ROE, ROA, margins, equity ratio, D/E, FCF) and the accounting standard marked per year.

/mcp · x402

Agent-native

Every endpoint is an MCP tool and answers a keyless 402 payment challenge — agents discover, pay and query with no signup.

02 — Endpoints

Six read endpoints, one unified schema.

Company key is {market}/{code}, e.g. jp/7203. Prices are the x402 per-call rate; subscribers call the same routes with a key. Every example below is the real request and response the API returns.

GET /v2/companies/:market/:code+Company profile and latest fundamentals for a Japanese listed company in an EDGAR-style unified schema.

Request

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

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.

Request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/2212/financials?years=6"

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.

Request

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

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": "ＫＤＤＩ㈱",
        "shares": 363365900,
        "balance_sheet_value": 989627000000,
        "purpose": "自動車関連（情報）取引の維持・発展[株式数が変動した理由]株式分割、一部売却のため"
      },
      {
        "issuer": "ＮＴＴ㈱",
        "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.

Request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/screener?roe_gte=5&revenue_gte=100000000000&limit=1"

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.

Request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/rankings?metric=roe&order=desc&limit=2"

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.

Request

curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/calendar?from=2026-06-20&to=2026-06-30"

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

Amounts carry a currency field; the accounting standard (JGAAP / IFRS / US GAAP) comes from the filing. Unknown query parameters are rejected with a corrective 400. Banks and insurers carry a financials_summary_only flag — their financials are summary-only (their statement layout differs).

03 — Plans

Free to try, flat to scale, metered for agents.

A free account gets you a key in seconds. One flat price removes the quota. Agents can skip accounts entirely and pay per call.

Free

¥0

100 calls (lifetime, per account) — no card, no checkout.

Create a free account and your key is issued on your account page, where you can rotate or revoke it. The quota never resets — when it runs out, upgrade or pay per call.

Get a free key

Standard

¥1,500/month

Unlimited calls — fair-use rate limit (100 requests / 10s).

First month free (card required). No daily or monthly quota. Buying Standard upgrades your existing keys in place — no new key to swap into your code. Cancel anytime in the Stripe portal; your keys aren't revoked, they fall back to the free plan.

Subscribe

Agents can also pay per call without an account — no key, a 402 payment challenge settled in USDC on Base, from $0.002/call. See /x402 for the agent onboarding guide.

A free account that has spent its 100 lifetime calls gets 429 on every free key (the quota is account-wide and never resets) — upgrade to Standard and your existing keys keep working as-is (no re-issue), or drop the X-API-Key header to continue via x402. Standard keys are never quota'd; bursts above the fair-use rate get 429 with a Retry-After of a few seconds.

04 — Quickstart

Authenticate with one header.

Send your key as the X-API-Key header (issued once on your account page):

# Toyota (7203): profile + latest normalized metrics
curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/7203"

# 6-year time series
curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/companies/jp/7203/financials?years=6"

# Screener: ROE ≥ 10%, food sector
curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/screener?roe_gte=10§or=%E9%A3%9F%E6%96%99%E5%93%81"

# Rankings by ROE
curl -H "X-API-Key: kkp_..." \
  "https://api.kakerapetit.dev/v2/rankings?metric=roe&limit=20"

# No key? Same endpoint, pay per call via x402:
curl -i "https://api.kakerapetit.dev/v2/companies/jp/7203"   # → 402 + payment challenge
05 — MCP server

The same data as MCP tools.

Connect any MCP client to https://api.kakerapetit.dev/mcp (streamable HTTP) and get six tools that share your key's quota and rate limit with the REST endpoints:

get_companyget_financialsget_governance screen_companiesget_rankingsget_filings_calendar

Once connected, ask your agent things like:

  • Screen Japanese companies with ROE above 12% and revenue over ¥1T
  • Compare Toyota and Honda's operating margins over the last 5 years
  • Who are the top shareholders of Nintendo?
  • Which companies filed annual reports last week?

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 the header Authorization: Bearer kkp_....

Any MCP client

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

Requests without a valid key get 401 — grab a free key from the plans above. A free key past its lifetime quota keeps its MCP session but tool calls return an error explaining the Standard upgrade and the x402 fallback. OAuth is not supported yet (static API keys only; OAuth is planned).

Start with 100 free calls.

A key in under a minute. No card required.

Get free API key