# EDINET Japanese Stock Rankings by Financial Metric

> EDINET Japanese Stock Rankings by Financial Metric is a paid API for AI agents from api.kakerapetit.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Ranks Japanese listed companies by any specified financial metric from EDINET annual reports, returning top or bottom N companies with full normalized indicator data

## Facts

- Endpoint: GET https://api.kakerapetit.dev/v2/rankings
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edinet-japanese-stock-rankings-by-financial-metric-a7d489a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fmIrO8Y_erLDwt5woAol4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability edinet-japanese-stock-rankings-by-financial-metric-a7d489a7
```

Example prompt: Show me the top 10 Japanese listed companies ranked by ROE in descending order using their latest EDINET annual report data.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edinet-japanese-stock-rankings-by-financial-metric-a7d489a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.kakerapetit.dev](https://www.zero.xyz/host/api.kakerapetit.dev/llms.txt)