{"uid":"cap_fmIrO8Y_erLDwt5woAol4","slug":"edinet-japanese-stock-rankings-by-financial-metric-a7d489a7","name":"EDINET Japanese Stock Rankings by Financial Metric","description":"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.","url":"https://api.kakerapetit.dev/v2/rankings","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["metric"],"properties":{"limit":{"type":"integer","maximum":100,"minimum":1,"description":"Max rows (default 50, max 100)."},"order":{"enum":["desc","asc"],"type":"string","description":"Sort direction (default \"desc\")."},"market":{"enum":["jp"],"type":"string","description":"Market segment (default: all; only jp today)."},"metric":{"type":"string","description":"Metric column to rank by (whitelisted): any indicator (revenue, total_assets, …) or ratio (roe, roa, operating_margin, equity_ratio, de_ratio, asset_turnover, fcf)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QxfJv5Wbf8vvb50eZckk3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks Japanese listed companies by any specified financial metric from EDINET annual reports, returning top or bottom N companies with full normalized indicator data","exampleAgentPrompt":"Show me the top 10 Japanese listed companies ranked by ROE in descending order using their latest EDINET annual report data.","exampleUseCases":null,"resultDescription":"A ranked list of up to N Japanese listed companies (default 50, max 100) sorted by the requested metric, each entry containing the full normalized financial indicator row (revenue, total assets, ROE, ROA, operating income, net income, equity ratio, FCF, etc.) and filing provenance metadata from the latest fiscal year EDINET annual securities report.","failureModes":["Invalid or non-whitelisted metric name returns 400 error","Limit exceeds maximum of 100 returns validation error","No data available for requested market segment returns empty result set","EDINET data lag means very recently filed reports may not yet be indexed","Network timeout if EDINET data layer is slow to respond"],"whenToPreferThis":"Use this endpoint when you need a ranked league table of Japanese listed companies by a specific financial metric — ideal for factor screening, identifying top/bottom performers, or building comparative analyses across the Japanese equity universe. Prefer this over the screener endpoint when you want pure ranking by a single metric rather than multi-criteria filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:54.169Z","isFirstParty":false}