data_object

Random Bytes

Operational

Raw verifiable random bytes in hex or base64

API Overview

Raw random bytes are the building block for cryptographic key material, nonces, salts, and initialization vectors. This endpoint exposes the drand beacon's randomness directly, optionally re-encoding to hex or base64. The BLS12-381 proof in every response lets any party confirm the bytes weren't generated by a backdoored PRNG — they're derived deterministically from a publicly verifiable distributed randomness beacon.

data_object

Raw Entropy

Bytes derive directly from the drand threshold beacon — no local PRNG involved.

code_blocks

Hex & Base64 Output

Choose the encoding that fits your pipeline — hex for readability, base64 for compact transport.

shield

BLS12-381 Proof

Every response carries the beacon signature so the randomness source can be independently audited.

speed

Up to 1024 Bytes

Enough entropy for any standard cryptographic primitive in a single sub-50ms call.

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/bytes

Body Parameters

Parameter	Type	Required	Description
`length`	integer	Yes	Number of bytes to generate (1–1024)
`encoding`	string	No	Output encoding: hex (default) or base64

terminal API Playground

Live Simulation

length * (integer)

encoding (string)

import requests

url = "https://random.picopayd.codefission.co.uk/api/random/bytes"
params = {"length": 32, "encoding": "hex"}
headers = {"X-PAYMENT": "<402-payment-token>"}

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

const params = new URLSearchParams({ length: 32, encoding: 'hex' });
const response = await fetch(
  `https://random.picopayd.codefission.co.uk/api/random/bytes?${params}`,
  { headers: { "X-PAYMENT": "<402-payment-token>" } }
);
const data = await response.json();
console.log(data);

curl "https://random.picopayd.codefission.co.uk/api/random/bytes?length=32&encoding=hex" \
  -H 'X-PAYMENT: <402-payment-token>'

Response Body 200 OK

{
  "data": "a87619810b1b41e70a01b8f903cf6997c4a2d3b5e9f10234567890abcdef1234",
  "length": 32,
  "encoding": "hex",
  "proof": {
    "round": 21543892,
    "signature": "95a9...",
    "chainHash": "52db9b...",
    "timestamp": "2026-03-20T10:00:00Z"
  }
}