# YRUZ Random Number Generator

> YRUZ Random Number Generator is a paid API for AI agents from yruz.one, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Generates one or more random integers within a specified min/max range

## Facts

- Endpoint: POST https://yruz.one/api/toolkit/random-number-generator?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yruz-random-number-generator-cca07cfd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yja8Akbx7QrcBTuBhP7rX

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 yruz-random-number-generator-cca07cfd -d '<json body>'
```

Example prompt: Generate 5 random numbers between 1 and 50 for me.

## When to prefer this

Choose this endpoint when you need a quick, pay-per-use random number generation utility without setting up a local PRNG, especially when already operating in an x402 micropayment environment and need 1–100 numbers in a defined integer range.

## Known failure modes

- Count outside 1-100 range may cause an error or be clamped
- Non-numeric string values for min/max/count may result in unexpected behavior or an error
- Min value greater than max value may produce an invalid result
- Payment failure via x402 protocol returns a 402 status before generation occurs

## How this service works

YRUZ is a free social network: create a profile, join public groups, attend events, read free guides on community building and creator income.

## Output

Returns a JSON object with the tool name 'random-number-generator' and a result field containing the generated random number(s) within the requested min/max range.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "max": {
   "type": "string",
   "description": "default 100"
  },
  "min": {
   "type": "string",
   "description": "default 0"
  },
  "count": {
   "type": "string",
   "description": "1-100"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "random-number-generator",
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yruz-random-number-generator-cca07cfd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from yruz.one](https://www.zero.xyz/host/yruz.one/llms.txt)