# SignalHarness Agent Trace Failure Extractor

> SignalHarness Agent Trace Failure Extractor 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).

Analyzes a submitted agent trace or execution log JSON to extract and identify failure patterns, errors, and warnings.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/agent_trace_failure_extract/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-agent-trace-failure-extractor-a3496a97
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EYMqDr8jMBEZ1jIBAxoZe

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-agent-trace-failure-extractor-a3496a97 -d '<json body>'
```

Example prompt: Can you analyze this agent trace JSON and extract all the failure patterns and warnings from the run — here's the trace: {paste JSON}?

## When to prefer this

Choose this endpoint when you need to programmatically extract and structure failure information from an agent trace or execution log JSON, especially in automated observability pipelines or post-mortem workflows where a signed receipt for the analysis is needed. Prefer it over manual log review when working with structured agent trace formats that need machine-readable failure extraction at scale.

## Known failure modes

- Malformed or invalid JSON in request_json field returns a parse error
- Input JSON exceeding 65536 characters is rejected
- Missing required request_json field causes validation failure
- Empty or near-empty JSON string (minLength 2) may yield minimal analysis
- Network or payment failure returns non-succeeded status in receipt

## 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 JSON object containing an analysis_json field with structured failure details, a list of warnings, an evidence_scope indicator (e.g. caller_supplied_data), and a full signed receipt with payment metadata, execution timing, result hash, and service version for auditability.

## 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": "agent_trace_failure_extract",
   "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": "agent_trace_failure_extract",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "5000",
   "resultSha256": "a12b216791268c362f5cf63f33baccd2ef86773063675d76d64c0323c3a4c007",
   "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-agent-trace-failure-extractor-a3496a97/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)