---
name: x402-random.vercel.app
description: x402-random.vercel.app exposes a single paid API endpoint that generates one random number per request within a caller-specified min/max range. Each request costs $0.01 USDC and returns the random number alongside timestamp, cost, and network metadata.
host: x402-random.vercel.app
---

# x402-random.vercel.app

This host is a minimal, pay-per-use random number service built on the x402 payment protocol. It serves agents that need a server-generated random number with an auditable payment trail and basic metadata. It is not a general-purpose randomness library or bulk generation service — it handles exactly one number per paid call.

## When to use this host

Use this host when an agent needs a single server-generated random number within a defined range and the payment receipt or network metadata must accompany the result — for example, to create an auditable record that a paid, external source produced the value. Do not use it for bulk or batch random number generation (it returns one number per $0.01 USDC request), cryptographic-grade randomness, or high-frequency sampling where per-call costs would accumulate significantly. For free or high-volume random number needs, use a local PRNG or a free randomness API instead.

## Capabilities

### Random Number Generation

Generates a single random number within a specified min/max range, returning the result with timestamp, cost, and network metadata per paid request.

- **`generate-random-number`** — Generates a single random number within a caller-specified min/max range, returning the result with timestamp, cost, and network metadata.

## Skill reference

### `generate-random-number`

**USDC Random Number API** — Generates a single random number within a caller-specified min/max range, returning the result with timestamp, cost, and network metadata.

*Use when:* Use when an agent needs a verifiably paid, server-generated random number within a specific integer or decimal range and requires metadata such as cost and network confirmation alongside the result.

*Not for:* Do not use for bulk random number generation or cryptographic randomness requirements; this endpoint returns a single number per paid request at $0.01 USDC each.

**Inputs:**

- `min` (number) — Minimum value for the random number (inclusive). Defaults to 1.
- `max` (number) — Maximum value for the random number (inclusive). Defaults to 100.

**Returns:** Returns success=true, a randomNumber within the requested range, the echoed range object, an ISO timestamp, cost string (e.g. '0.01 USDC'), and the payment network ('base').

**Example:** `{"min": 100, "max": 101}`

---