# NPB Official Fielding Statistics by Season

> NPB Official Fielding 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 fielding statistics for all qualified fielders by position, league, and season from npb.jp BIS data

## Facts

- Endpoint: POST https://oracle-api-production-766f.up.railway.app/v1/npb/players/fielders/: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-fielding-statistics-by-season-da2ae5a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3GMNQVzT2OIXDX0Yj9f3T

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-fielding-statistics-by-season-da2ae5a9 -d '<json body>'
```

Example prompt: Can you pull the official NPB fielding rankings for the 2023 season — I want to see position-by-position stats like fielding percentage, putouts, assists, errors, and double plays for both Central and Pacific League qualified fielders?

## When to prefer this

Use this endpoint when you need official NPB fielding statistics broken down by position and league for a full season, especially for defensive analysis, sabermetric research, or fantasy baseball defensive value assessments. Prefer this over individual player lookups when you want ranked lists of all qualified fielders across all positions simultaneously.

## Known failure modes

- Season out of range (pre-2005 or post-2025) returns error or empty data
- Invalid season format returns 400 bad request
- No qualified fielders for a position in a given season returns empty array
- Payment not provided or insufficient USDC causes 402 Payment Required
- Network timeout from Railway hosting causes 503
- NPB source data unavailable for very recent seasons may return incomplete results

## How this service works

Japanese baseball (NPB) official fielding statistics for a given season. Returns position-by-position (first base, second base, third base, shortstop, outfield, catcher, pitcher) ranking with fielding percentage, games, putouts, assists, errors, double plays, and passed balls (catcher only) for all qualified fielders (規定試合数 met) split by Central League and Pacific League. Source: npb.jp official BIS fielding ranking. Coverage: 2005-2025 (21 seasons). Use cases: defensive metric analysis (UZR / DRS proxy), fantasy baseball defensive value, sabermetric research, lineup optimization, AI baseball analytics agents covering Japanese leagues. Input: :season (YYYY). Output: JSON {season, league, category:"fielders", source, subleagues:{central:{criteria_note,positions:{first_base:[],second_base:[],...,catcher:[],pitcher:[]}}, pacific:{...}}}. Pay-per-call $0.005 USDC on Solana mainnet.

## Output

A JSON object containing season, league, category ('fielders'), source (npb.jp), and subleagues object with central and pacific keys, each containing criteria_note and positions object mapping position names (first_base, second_base, third_base, shortstop, outfield, catcher, pitcher) to arrays of ranked player records with fielding stats. Catcher records include passed balls.

## 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-fielding-statistics-by-season-da2ae5a9/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)