# PQS Grade — Prompt Quality Quick Score

> PQS Grade — Prompt Quality Quick Score is a paid API for AI agents from promptqualityscore.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Scores a prompt text with a composite 0-100 score, A-F letter grade, three framework sub-scores (PEEM, RAGAS, G-Eval), and a pass/fail verdict for use as a cheap pre-flight filter before expensive LLM calls

## Facts

- Endpoint: GET https://promptqualityscore.com/api/pqs-grade
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/promptqualityscore-com-42826a44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xxP40lgZCHhr29XzxiMs2

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 promptqualityscore-com-42826a44
```

Example prompt: Before I send this to Claude, can you run a quick quality check on this prompt and give me a composite score, letter grade, and the PEEM, RAGAS, and G-Eval sub-scores — treat it as a software domain prompt: 'You are an expert Python developer. Given a buggy function below, identify the root cause and return a corrected version with inline comments explaining each fix.'

## When to prefer this

Use this endpoint as the cheapest gate in an agentic pipeline when you want to discard low-quality prompts before spending on a costlier LLM inference call. Prefer it when you need a fast, multi-framework quality signal (PEEM, RAGAS, G-Eval all at once) with a human-readable grade rather than running a full LLM evaluation pass yourself.

## Known failure modes

- Empty or missing prompt text returns a 400 validation error
- Prompt exceeding 10,000 characters is rejected
- Unrecognized vertical enum value causes a validation error
- Network timeout if the scoring service is under load
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Quick pre-flight quality score: composite (0-100) + grade (A-F) + three framework sub-scores (PEEM, RAGAS, G-Eval) + verdict. Run upstream of any other paid call to filter weak prompts before inference. The cheapest gate on the AI input quality problem.

## Output

Returns a composite quality score from 0-100, a letter grade from A to F, individual sub-scores for the PEEM, RAGAS, and G-Eval frameworks, and an overall verdict indicating whether the prompt is ready for submission to a paid LLM.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompt": {
   "type": "string",
   "description": "Prompt text to grade (1-10000 chars)"
  },
  "vertical": {
   "type": "string",
   "description": "Optional domain: software/content/business/education/science/crypto/general/research"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "score",
  "grade",
  "verdict",
  "frameworks"
 ],
 "properties": {
  "grade": {
   "enum": [
    "A",
    "B",
    "C",
    "D",
    "F"
   ],
   "type": "string"
  },
  "score": {
   "type": "integer",
   "maximum": 100,
   "minimum": 0,
   "description": "Composite 0-100 score (percentile-normalized total)"
  },
  "verdict": {
   "type": "string",
   "description": "Single sentence diagnosing the weakest dimension, with a framework citation"
  },
  "frameworks": {
   "type": "object",
   "required": [
    "peem",
    "ragas",
    "geval"
   ],
   "properties": {
    "peem": {
     "type": "number",
     "maximum": 10,
     "minimum": 0,
     "description": "PEEM framework score: weights structure (clarity, output format, role, constraints)"
    },
    "geval": {
     "type": "number",
     "maximum": 10,
     "minimum": 0,
     "description": "G-Eval framework score: weights LLM-judged faithfulness (clarity, specificity, CoT, constraints)"
    },
    "ragas": {
     "type": "number",
     "maximum": 10,
     "minimum": 0,
     "description": "RAGAS framework score: weights grounding (context, specificity, examples)"
    }
   }
  },
  "upgrade_url": {
   "type": "string",
   "description": "Link to PQS Pro for the full 8-dimension SaaS"
  },
  "methodology_url": {
   "type": "string",
   "description": "Link to the methodology blog post explaining the five-framework synthesis"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/promptqualityscore-com-42826a44/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from promptqualityscore.com](https://www.zero.xyz/host/promptqualityscore.com/llms.txt)