# NPB Official Batter Ranking Statistics by Season

> NPB Official Batter Ranking Statistics 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 batting statistics (BA, OBP, SLG, HR, RBI, SB, and more) for all qualified batters split by Central and Pacific League for a given season (2005–2025).

## Facts

- Endpoint: POST https://oracle-api-production-766f.up.railway.app/v1/npb/players/batters/: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-batter-ranking-statistics-by-season-25e18a11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-loPKR0nT04Ii3vus2vxO

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-batter-ranking-statistics-by-season-25e18a11 -d '<json body>'
```

Example prompt: Pull the official NPB batter rankings for the 2023 season — I want to see batting average, OBP, slugging, home runs, and RBIs for all qualified hitters in both the Central and Pacific Leagues.

## When to prefer this

Use this endpoint when you need official NPB batting leaderboard statistics for an entire season, including all qualified batters split by league. Ideal for fantasy baseball lineup decisions, sabermetric research, historical comparisons, and AI agents covering Japanese professional baseball. Prefer this over individual player lookup endpoints when you need the full ranked list rather than a single player's stats.

## Known failure modes

- Season out of range (before 2005 or after 2025) returns an error or empty result
- Invalid season format (non-YYYY) causes a 400 bad request
- Payment not completed on Solana mainnet results in 402 Payment Required
- No qualified batters found for an edge-case season returns empty player arrays
- Network/service downtime on Railway returns 5xx errors

## How this service works

Japanese baseball (NPB) official batter ranking statistics for a given season. Returns batting average (打率), on-base percentage (出塁率), slugging (長打率), home runs (本塁打), RBIs (打点), stolen bases (盗塁), plate appearances, hits, doubles, triples for all qualified batters (規定打席 met) split by Central League and Pacific League. Source: npb.jp official BIS ranking. Coverage: 2005-2025 (21 seasons). Use cases: NPB fantasy baseball lineup setting, hitter matchup analysis, sabermetric research, league leader comparison, longitudinal hitter projection, 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 season, league category, and source, with subleagues broken into Central and Pacific League arrays. Each player entry includes batting average, on-base percentage, slugging percentage, home runs, RBIs, stolen bases, plate appearances, hits, doubles, and triples. Only qualified batters (規定打席 met) are included.

## 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-batter-ranking-statistics-by-season-25e18a11/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)