{"uid":"cap_QtybFnvmT6fOyYMPHhHEe","slug":"grades-study-calc-percentile-rank-c8bdba19","name":"Grades & Study Calc – Percentile Rank","description":"Percentile rank of a score in a class list (mean-rank method), with rank from the top, mean, median and z-score.","url":"https://grades-calc.x402tookit.com/percentile-rank?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":["scores","yourScore"],"properties":{"scores":{"type":"string","description":"Comma-separated class scores, 2 to 500"},"yourScore":{"type":"number","description":"The score to place in the class"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"mean":{"type":["null","number"]},"score":{"type":["null","number"]},"median":{"type":["null","number"]},"source":{"type":["null","string"]},"zScore":{"type":["null","number"]},"maximum":{"type":["null","number"]},"minimum":{"type":["null","number"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"classSize":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"rankFromTop":{"type":["null","number"]},"scoresAbove":{"type":["null","number"]},"scoresBelow":{"type":["null","number"]},"scoresEqual":{"type":["null","number"]},"percentileRank":{"type":["null","number"]},"sampleStandardDeviation":{"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_B80Z4ipkD-Ez4OV6WCMRn","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":"Calculates the percentile rank of a score within a class list using the mean-rank method, returning rank from top, mean, median, z-score, and surrounding score counts.","exampleAgentPrompt":"My class scores are 55,62,70,73,73,75,78,80,82,85,88,90,91,95 — can you tell me what percentile rank my score of 82 is in, along with the class mean, median, and z-score?","exampleUseCases":[{"title":"Student checking exam standing","prompt":"The class got these scores on the midterm: 45,52,60,63,67,70,72,75,78,80,83,85,88,92,95 — I got a 78. What percentile am I in, and what's the average and z-score?"},{"title":"Teacher analyzing a student's performance","prompt":"I have a class of 10 students with scores 55,60,65,70,70,75,80,85,90,95 and one student scored 65. Can you calculate their percentile rank and tell me how many scored above and below them?"},{"title":"Competitive student benchmarking grade","prompt":"My physics class scores were 40,50,55,60,65,70,75,78,80,82,85,88,91,93,97 and I scored 91. What percentile rank is that using the mean-rank method, and what's the class median?"}],"resultDescription":"Returns a JSON object with the student's percentile rank (0–100), rank from the top of the class, number of scores above/below/equal to the given score, class size, mean, median, z-score, minimum, maximum, sample standard deviation, a summary verdict, and optional disclaimer or degraded-mode flags.","failureModes":["Fewer than 2 scores in the comma-separated list returns an error","Non-numeric values in the scores string cause a parse failure","More than 500 scores exceeds the class size limit","yourScore not provided returns a validation error","Network timeout or x402 payment failure prevents a result"],"whenToPreferThis":"Choose this endpoint when you need a statistically grounded percentile rank using the mean-rank method alongside descriptive statistics (mean, median, z-score) for a single score within a known class list. It is ideal for academic grading contexts where the full class score distribution is available and you want more than just a raw rank — particularly when z-score and surrounding counts add context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:11:21.249Z","isFirstParty":false,"canonicalSlug":"grades-study-calc-percentile-rank-c8bdba19"}