# Delx Commerce Idempotency Key Generator

> Delx Commerce Idempotency Key Generator is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-01).

Generates a deterministic idempotency key from a JSON payload and namespace, enabling agents to deduplicate or track logical operations uniquely.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/idempotency-key?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-idempotency-key-generator-3699d915
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JOKltjWVdcm_sS4soNWkG

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 delx-commerce-idempotency-key-generator-3699d915 -d '<json body>'
```

Example prompt: Generate a deterministic idempotency key for this order payload — use the namespace 'orders' and hash the JSON object {"order_id":"abc123","amount":50} so I can safely retry without duplicating the operation.

## When to prefer this

Choose this endpoint when you need a deterministic, verifiable idempotency key derived from a JSON payload without building your own hashing infrastructure. It is especially useful for AI agents that need to deduplicate operations across retries, track logical tasks, or fingerprint structured data in a namespaced, auditable way. Prefer it over rolling your own SHA-256 logic when you want a standardized 'delx/idempotency-key/v1' schema with verifiable delivery semantics.

## Known failure modes

- Invalid or non-serializable payload may result in a 400 error
- Namespace exceeding 200 characters will be rejected
- Payment failure via x402 protocol (insufficient USDC balance) will block the request
- Malformed JSON in request body may cause parsing errors
- Network or blockchain settlement delays may cause timeouts

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

Returns a structured JSON object containing a unique deterministic idempotency key (prefixed 'delx_'), the SHA-256 hash of the canonical payload, the namespace used, the algorithm identifier ('sha256'), and the schema version ('delx/idempotency-key/v1'). The key is stable and reproducible for identical inputs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "payload": {
   "description": "JSON value whose canonical representation identifies one logical operation."
  },
  "namespace": {
   "type": "string",
   "default": "default",
   "maxLength": 200
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "key": "delx_ca094a4752e182cfcac50a38d65de7c7e4f271ee05c08f26853c75f0ba24b049",
  "schema": "delx/idempotency-key/v1",
  "algorithm": "sha256",
  "namespace": "default",
  "payload_sha256": "f85c6736261be7d990522f91e81634f844ad23c515f3b4029e197ab01a2d18dc"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-idempotency-key-generator-3699d915/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)
