{"uid":"cap_XuZjQSBPeKhah-opwGGbM","slug":"chess-notation-tools-material-balance-from-fen-c83237f9","name":"Chess Notation Tools – Material Balance from FEN","description":"Material balance from a FEN: standard 1-3-3-5-9 point totals per side, difference and piece lists.","url":"https://chess-notation.x402tookit.com/material-count?utm_source=zero.xyz","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":["fen"],"properties":{"fen":{"type":"string","description":"A FEN string (only the placement field is read)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"black":{"type":["null","object"],"properties":{"pawns":{"type":["null","number"]},"rooks":{"type":["null","number"]},"queens":{"type":["null","number"]},"bishops":{"type":["null","number"]},"knights":{"type":["null","number"]}}},"white":{"type":["null","object"],"properties":{"pawns":{"type":["null","number"]},"rooks":{"type":["null","number"]},"queens":{"type":["null","number"]},"bishops":{"type":["null","number"]},"knights":{"type":["null","number"]}}},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"difference":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"blackPoints":{"type":["null","number"]},"whitePoints":{"type":["null","number"]},"blackHasBishopPair":{"type":["boolean","null"]},"whiteHasBishopPair":{"type":["boolean","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ebo_47f2aT32r1bipQUDk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes material balance from a FEN string using standard piece values (1-3-3-5-9), returning point totals for each side, their difference, and per-piece counts.","exampleAgentPrompt":"What's the material balance for the position 'r1bqkb1r/pppp1ppp/2n2n2/4p3/2B1P3/5N2/PPPP1PPP/RNBQK2R w KQkq - 4 4'? Tell me how many points each side has and who's ahead.","exampleUseCases":[{"title":"Evaluating middlegame material advantage","prompt":"I have this FEN from a game I'm analyzing: 'r4rk1/pp3ppp/2n1bn2/3p4/3P4/2N1BN2/PP3PPP/R4RK1 w - - 0 12' — can you tell me the material count for white and black and who has more points?"},{"title":"Detecting one-sided endgame material","prompt":"Here's the endgame position FEN: '8/5pk1/6p1/8/8/6P1/5PK1/3Q4 w - - 0 40' — can you show me the piece counts and total point values for each side so I know how lopsided the material is?"},{"title":"Checking if bishop pair bonus applies","prompt":"Does either side have the bishop pair in the position 'rn1qkb1r/ppp2ppp/4pn2/3p4/2PP4/2N2N2/PP2PPPP/R1BQKB1R w KQkq - 0 5'? Also give me the full material tally."}],"resultDescription":"Returns per-side piece counts (pawns, knights, bishops, rooks, queens), total points for white and black using standard values (P=1, N=3, B=3, R=5, Q=9), the numeric material difference (positive = white ahead), bishop pair flags for each side, a summary verdict, and optional metadata fields like source, degraded status, and disclaimer.","failureModes":["Missing or malformed FEN query parameter returns an error","FEN with invalid placement field (wrong number of ranks/files) may cause parsing failure","Non-FEN strings passed as the fen parameter return validation errors","Kings are not counted in point totals (by design), which may surprise callers expecting full piece lists"],"whenToPreferThis":"Choose this endpoint when you need a fast, structured material count from a FEN string using the standard chess point system. It is ideal for game analysis pipelines, chess tutoring bots, or position evaluation steps where you need numeric material totals and per-piece breakdowns without running a full engine evaluation. Prefer it over a full engine call when material balance alone is sufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:15:02.861Z","isFirstParty":false,"canonicalSlug":"chess-notation-tools-material-balance-from-fen-c83237f9"}