# SignalHarness RAG Retrieval Result Normalizer

> SignalHarness RAG Retrieval Result Normalizer is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Normalizes and validates RAG (Retrieval-Augmented Generation) retrieval result JSON into a standardized, schema-compliant format with warnings about data provenance.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/rag_retrieval_result_normalize/invoke
- 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/signalharness-rag-retrieval-result-normalizer-ce8e1ada
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YPur8GvIwDrh0rU2lrllY

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 signalharness-rag-retrieval-result-normalizer-ce8e1ada -d '<json body>'
```

Example prompt: I just got back a raw JSON blob from my RAG retrieval step and need it normalized into a clean, schema-valid format — can you run it through the SignalHarness RAG result normalizer? Here's the JSON: {"documents":[{"id":"abc123","score":0.92,"text":"Climate change impacts..."}]}

## When to prefer this

Choose this endpoint when you need a lightweight, pay-per-call normalization step for RAG retrieval results within an agentic pipeline, especially when retrieval sources vary in schema or format. It is particularly useful when you want a receipt/audit trail (SHA256 hash, payment ID) for each normalization call, or when operating in a Base/USDC micropayment environment. Prefer alternatives if you need heavy-duty ETL, batch processing of many results at once, or normalization of non-RAG data types.

## Known failure modes

- Invalid or malformed JSON in request_json field — returns parse error
- request_json string too short (< 2 chars) or too long (> 65536 chars) — returns validation error
- Payment failure via x402 protocol — service not invoked
- Caller-supplied data contains schema-incompatible structure — may return warnings rather than hard failure
- Network or execution timeout — receipt may show failed status

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns a structured JSON object containing: a normalized `analysis_json` string with the standardized retrieval data, a list of `warnings` about data provenance (e.g. reminding the caller to verify data), an `evidence_scope` field indicating the data source (e.g. 'caller_supplied_data'), a `service_id`, and a full payment receipt including request/execution IDs, USDC amount, network details, and a SHA256 hash of the result for integrity verification.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "request_json": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "warnings": [
    "Verify the caller-supplied data before relying on this result."
   ],
   "service_id": "rag_retrieval_result_normalize",
   "analysis_json": "{\"example\":\"schema-valid caller-supplied data\"}",
   "evidence_scope": "caller_supplied_data"
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "rag_retrieval_result_normalize",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "5000",
   "resultSha256": "d0a857ce50979a8d3d0650dce54a1de2f0bbf2b4d809de732c28684099fe03cc",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signalharness-rag-retrieval-result-normalizer-ce8e1ada/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)