# NPB Official Pitcher Rankings by Season

> NPB Official Pitcher Rankings by Season is a paid API for AI agents from oracle-api-production-766f.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Returns official NPB pitcher ranking statistics for all qualified pitchers in a given season, split by Central League and Pacific League.

## Facts

- Endpoint: POST https://oracle-api-production-766f.up.railway.app/v1/npb/players/pitchers/:season
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/npb-official-pitcher-rankings-by-season-f1ee6933
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dZN8rZQ3L59JasLLFHIWl

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 npb-official-pitcher-rankings-by-season-f1ee6933 -d '<json body>'
```

Example prompt: Pull the official NPB pitcher rankings for the 2023 season — I want ERA, wins, saves, strikeouts, and innings pitched for all qualified pitchers in both the Central League and Pacific League.

## When to prefer this

Use this endpoint when you need official, structured NPB pitcher ranking data for a full season split by league, especially for fantasy baseball pitcher selection, sabermetric research, or building AI baseball analytics agents focused on Japanese leagues. Covers 21 seasons (2005-2025) from the official NPB BIS source.

## Known failure modes

- Invalid or out-of-range season year (outside 2005-2025) returns an error
- No qualified pitchers found for a partial/current season may return empty arrays
- Network timeout from upstream npb.jp data source
- Missing or malformed :season parameter in request path
- Payment not confirmed on Solana mainnet resulting in 402 rejection

## How this service works

Japanese baseball (NPB) official pitcher ranking statistics for a given season. Returns ERA, appearances (登板), wins, losses, saves, holds, IP (投球回), strikeouts (三振), walks (四球), WHIP-related raw counts for all qualified pitchers (規定投球回 met) split by Central League and Pacific League. Source: npb.jp official BIS ranking. Coverage: 2005-2025 (21 seasons). Use cases: NPB fantasy baseball pitcher selection, pitcher matchup analysis, sabermetric research, longitudinal performance comparison, AI baseball analytics agents covering Japanese leagues. Input: :season (YYYY). Output: JSON {season, league, category, source, subleagues:{central:{criteria_note,players[]}, pacific:{...}}}. Pay-per-call $0.005 USDC on Solana mainnet.

## Output

A JSON object containing the requested season, league category, and source, with two sub-objects for Central League and Pacific League each listing all qualified pitchers (規定投球回 met) and their full stat lines including ERA, appearances, wins, losses, saves, holds, innings pitched, strikeouts, walks, and WHIP-related raw counts.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "season"
     ],
     "properties": {
      "season": {
       "type": "string",
       "pattern": "^\\d{4}$"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "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/npb-official-pitcher-rankings-by-season-f1ee6933/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracle-api-production-766f.up.railway.app](https://www.zero.xyz/host/oracle-api-production-766f.up.railway.app/llms.txt)