auto_fix_high

Dice Roll

Operational

Roll any number of dice with any number of sides — verifiably backed by drand

API Overview

The dice endpoint supports arbitrary polyhedral dice — from a simple d6 to a d1000 — for tabletop games, probabilistic simulations, and random selection. Each die result uses rejection sampling over drand beacon randomness for uniform distribution. The response includes individual roll results, the total sum, and the full beacon proof so any third party can verify the roll independently. POST your parameters as JSON for flexibility.

auto_fix_high

Any Polyhedron

d4, d6, d8, d10, d12, d20, d100 — or any custom die up to 1000 sides.

chart_data

Roll + Sum

Individual roll values and the total sum returned together — no client-side math needed.

verified

Provably Fair

Each roll is derived from the drand threshold beacon — independently verifiable by anyone.

shield

BLS12-381 Proof

Attach the beacon proof to your game log so disputes can be resolved without trusting the server.

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

POST /api/random/dice

Body Parameters

Parameter	Type	Required	Description
`sides`	integer	No	Number of sides per die (2–1000, default 6)
`count`	integer	No	Number of dice to roll (1–100, default 1)

terminal API Playground

Live Simulation

sides (integer)

count (integer)

import requests

url = "https://random.picopayd.codefission.co.uk/api/random/dice"
payload = {"sides": 6, "count": 4}
headers = {
    "Content-Type": "application/json",
    "X-PAYMENT": "<402-payment-token>"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch(
  "https://random.picopayd.codefission.co.uk/api/random/dice",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-PAYMENT": "<402-payment-token>"
    },
    body: JSON.stringify({ sides: 6, count: 4 })
  }
);
const data = await response.json();
console.log(data);

curl -X POST "https://random.picopayd.codefission.co.uk/api/random/dice" \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <402-payment-token>' \
  -d '{"sides": 6, "count": 4}'

Response Body 200 OK

{
  "rolls": [3, 6, 1, 4],
  "sides": 6,
  "total": 14,
  "proof": {
    "round": 21543892,
    "signature": "95a9...",
    "chainHash": "52db9b...",
    "timestamp": "2026-03-20T10:00:00Z"
  }
}