# Deterministic UUID v5 Generator

> Deterministic UUID v5 Generator is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Generates a deterministic UUID version 5 from a name and namespace string, returning the same UUID every time for the same inputs.

## Facts

- Endpoint: POST https://twin.unykorn.org/uuid-v5?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/deterministic-uuid-v5-generator-29181f9c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7MtpPF1uIHv2Wtzdny84V

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 deterministic-uuid-v5-generator-29181f9c -d '<json body>'
```

Example prompt: Generate a deterministic UUID v5 for the name 'user-profile' using the DNS namespace — I need the same UUID every time I pass that exact name.

## When to prefer this

Choose this endpoint when you need a UUID that is guaranteed to be identical every time for the same name and namespace inputs — ideal for distributed systems requiring consistent identifiers, deduplication keys, or deterministic record IDs without storing state. Prefer UUID v5 over v4 when reproducibility matters. Use this when you want a hosted, pay-per-call API rather than running UUID v5 generation locally.

## Known failure modes

- Missing or invalid name/namespace parameters returns an error response
- Invalid namespace format (must be a valid UUID or recognized namespace string) may cause computation failure
- Payment failure via x402 protocol results in 402 response and no UUID returned
- Network or service downtime returns a 5xx error

## How this service works

Deterministic UUID v5 from a name — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object with ok=true, the type field set to 'uuid-v5', the generated UUID (implied by the type and context), a transaction receipt containing a tx_hash (0x-prefixed 64-char hex), amount_usd, and a receipt_id (g402-prefixed 16-char hex), plus a generated_at ISO 8601 timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "name": {
     "type": "string"
    },
    "namespace": {
     "type": "string"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "uuid-v5",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.001,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/deterministic-uuid-v5-generator-29181f9c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)