chart_data

Random Number

Operational

Cryptographically verifiable random integers backed by the drand League of Entropy

API Overview

Each call fetches the latest drand League of Entropy beacon and derives unbiased integers via rejection sampling over BLS12-381 randomness. The response includes the full beacon proof (round number, signature, chain hash, timestamp) so any client can independently verify the output without trusting PicoPayd. Supports batch generation of up to 100 values per call, making it efficient for lotteries, A/B test assignment, and game mechanics.

verified

drand League of Entropy

Randomness sourced from a distributed threshold BLS network — no single party can predict or bias the output.

chart_data

Bias-Free Sampling

Rejection sampling ensures uniform distribution across any arbitrary integer range.

shield

BLS12-381 Proof

Every response carries the beacon signature so you can verify the randomness source independently.

speed

Batch Up to 100

Request up to 100 values in one API call — efficient for bulk assignments and draws.

integration_instructions API Reference

data_object openapi.json open_in_new Swagger UI

data_object

OpenAPI Spec

openapi.json

open_in_new

description

Swagger UI

Interactive API explorer

open_in_new

GET /api/random/number

Body Parameters

Parameter	Type	Required	Description
`min`	integer	No	Minimum value (inclusive, default 0)
`max`	integer	No	Maximum value (inclusive, default 2^53-1)
`count`	integer	No	Number of values to generate (1–100, default 1)

terminal API Playground

Live Simulation

min (integer)

max (integer)

count (integer)

import requests

url = "https://random.picopayd.codefission.co.uk/api/random/number"
params = {"min": 1, "max": 100, "count": 5}
headers = {"X-PAYMENT": "<402-payment-token>"}

response = requests.get(url, params=params, headers=headers)
print(response.json())

const params = new URLSearchParams({ min: 1, max: 100, count: 5 });
const response = await fetch(
  `https://random.picopayd.codefission.co.uk/api/random/number?${params}`,
  { headers: { "X-PAYMENT": "<402-payment-token>" } }
);
const data = await response.json();
console.log(data);

curl "https://random.picopayd.codefission.co.uk/api/random/number?min=1&max=100&count=5" \
  -H 'X-PAYMENT: <402-payment-token>'

Response Body 200 OK

{
  "values": [42, 17, 88, 5, 63],
  "min": 1,
  "max": 100,
  "proof": {
    "round": 21543892,
    "signature": "95a9...",
    "chainHash": "52db9b...",
    "timestamp": "2026-03-20T10:00:00Z"
  }
}