# agent402.tools ULID Generator

> agent402.tools ULID Generator is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Generates one or more sortable, timestamp-prefixed ULIDs (Universally Unique Lexicographically Sortable Identifiers) via a simple GET request.

## Facts

- Endpoint: GET https://agent402.tools/api/ulid
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-ulid-generator-791c5529
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zROUKh2l9E-d6UQQ8vvja

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 agent402-tools-ulid-generator-791c5529
```

Example prompt: Generate 5 ULIDs for me — I need sortable, timestamp-prefixed unique identifiers for some new database records.

## When to prefer this

Choose this endpoint when you need sortable, time-ordered unique identifiers rather than purely random UUIDs. ULIDs are preferable when lexicographic ordering by creation time matters (e.g., database primary keys, log entry IDs, event stream identifiers). Use this over the sibling UUID endpoint when timestamp-embedded sortability is a requirement.

## Known failure modes

- count parameter out of range (must be 1–100) returns an error
- missing or malformed query parameter returns a 400-level error
- payment not provided or insufficient returns a 402 Payment Required
- service unavailable returns a 5xx error

## How this service works

Generate ULIDs (sortable, timestamp-prefixed identifiers). ?count=1..100.

## Output

Returns one or more ULID strings — 26-character, base32-encoded, lexicographically sortable identifiers that embed a millisecond-precision timestamp prefix followed by random bits. The count of returned ULIDs matches the requested count (1–100).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "count": "5"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "count": {
       "type": "string",
       "description": "How many (1-100, default 1)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ulids"
     ],
     "properties": {
      "ulids": {
       "type": "array",
       "items": {
        "type": "string"
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ulids": [
   "01J9ZK7M3N…"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-ulid-generator-791c5529/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)