# SignalHarness Address Set Compare

> SignalHarness Address Set Compare 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).

Compares two or more sets of addresses and returns a structured comparison result with warnings and evidence scope

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/address_set_compare/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-address-set-compare-004cd38c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e_erYdm0nMmFCy5xzvf2y

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-address-set-compare-004cd38c -d '<json body>'
```

Example prompt: Compare these two sets of addresses and tell me where they differ or overlap: Set A is '123 Main St, Springfield; 456 Oak Ave, Portland' and Set B is '456 Oak Ave, Portland; 789 Elm Rd, Austin'.

## When to prefer this

Choose this endpoint when you need a fast, auditable, per-call comparison of two or more address sets with cryptographic receipt and evidence scope metadata. It is ideal for compliance, logistics reconciliation, or identity deduplication workflows where you need a structured diff of address collections rather than geocoding, validation of individual addresses, or full postal standardization.

## Known failure modes

- Input string too short (below minLength of 2) returns a validation error
- Input exceeds maxLength of 65536 characters causing rejection
- Malformed or unparseable address set string may yield incomplete comparison or warnings
- Payment failure via x402 protocol results in no execution and an error status
- Network or service errors may return a non-'succeeded' status in the 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 'address_set_comparison' field with the structured comparison result, a 'warnings' array for any issues detected, an 'evidence_scope' field indicating the data source (e.g. caller_supplied_data), and a full receipt with payment, execution, and latency metadata plus a result SHA-256 hash for integrity verification.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "warnings": [
    "Comparison is case-normalized only when requested by the caller."
   ],
   "service_id": "address_set_compare",
   "evidence_scope": "caller_supplied_data",
   "address_set_comparison": "{\"intersection\":[\"0x0000000000000000000000000000000000000002\"],\"only_left\":[\"0x0000000000000000000000000000000000000001\"],\"only_right\":[]}"
  },
  "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": "address_set_compare",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "5000",
   "resultSha256": "417f3a7d3c18a39fd1b045466e70fbb0d6c9beee1de37bb98c25f8756ffdc00f",
   "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-address-set-compare-004cd38c/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)