{"uid":"cap_tWKlzpfLrIxpxpTqH4GZF","slug":"grades-study-calc-percent-to-letter-grade-75cb138d","name":"Grades & Study Calc – Percent to Letter Grade","description":"Letter grade and 4.0 GPA points for a percentage on the common US scale, with plus/minus, and points to the next grade.","url":"https://grades-calc.x402tookit.com/percent-to-letter?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":["percent"],"properties":{"percent":{"type":"number","description":"Score in percent, 0 to 120"},"plusMinus":{"type":"string","description":"false for a plain A/B/C/D/F scale (default true)"},"roundHalfUp":{"type":"string","description":"true to round to the nearest whole percent first, the way many teachers do (default false)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"letter":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"gpaPoints":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"percentUsed":{"type":["null","number"]},"nextLetterUp":{"type":["null","string"]},"passingTypical":{"type":["boolean","null"]},"pointsToNextLetter":{"type":["null","number"]},"lowestPercentForThisLetter":{"type":["null","number"]}}}}}}},"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_WUy2-sLIF7Eyeyp8Rf941","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":"Converts a percentage score to a US letter grade (with optional plus/minus), 4.0 GPA points, and the points needed to reach the next grade up.","exampleAgentPrompt":"I got an 87% on my midterm — what letter grade is that on the US plus/minus scale, and how many points away am I from the next grade up?","exampleUseCases":[{"title":"Student checking exam grade","prompt":"I scored 91% on my chemistry exam. What letter grade is that with plus/minus, what are my GPA points, and how far am I from bumping up to the next letter?"},{"title":"Teacher grading without plus/minus","prompt":"A student got 74% on their assignment. Using a plain A/B/C/D/F scale with no plus or minus, what letter grade is that and is it passing?"},{"title":"Borderline score rounding check","prompt":"My raw score works out to 89.5% — if my professor rounds half up to the nearest whole percent first, what letter grade and GPA points do I get on the plus/minus scale?"}],"resultDescription":"Returns the letter grade (e.g. B+), 4.0 GPA points for that grade, the lowest percentage that earns this letter, how many percentage points are needed to reach the next letter up, whether the grade is typically passing, the percent actually used in the calculation, and metadata like source and summary.","failureModes":["Missing required 'percent' query parameter returns an error","Percent value outside 0–120 range may return an error or unexpected result","Invalid plusMinus or roundHalfUp string values may be ignored or cause errors","Network or service unavailability returns a non-200 response"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic conversion of a US percentage score to a letter grade with optional plus/minus granularity and GPA points — especially when you also need to know how close the score is to the next grade tier. Prefer it over manual lookup tables or GPA calculators that don't handle plus/minus or proximity to the next grade.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:08:16.345Z","isFirstParty":false,"canonicalSlug":"grades-study-calc-percent-to-letter-grade-75cb138d"}