swap_horiz

Coin Flip

Operational

Flip one or many verifiable coins backed by the drand League of Entropy beacon

API Overview

The coin flip endpoint uses drand beacon randomness to determine heads or tails for each flip via unbiased bit extraction. The response includes the full flip list, aggregate heads/tails counts, and the beacon proof for auditing. Designed for decision-making, giveaways, and protocol tie-breakers where a neutral third party is needed but a full smart contract is overkill.

swap_horiz

Up to 1,000 Flips

Bulk coin-flip results in a single API call — perfect for large draws and batch decisions.

verified

Provably Fair

Every flip is derived from the drand beacon — the source is public and independently verifiable.

chart_data

Aggregate Counts

Response includes total heads and tails counts alongside the full flip sequence.

shield

BLS12-381 Proof

Attach the beacon proof to your records so anyone can audit the outcome at any time.

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

Body Parameters

Parameter	Type	Required	Description
`count`	integer	No	Number of coin flips (1–1000, default 1)

terminal API Playground

Live Simulation

count (integer)

import requests

url = "https://random.picopayd.codefission.co.uk/api/random/coin"
params = {"count": 10}
headers = {"X-PAYMENT": "<402-payment-token>"}

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

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

curl "https://random.picopayd.codefission.co.uk/api/random/coin?count=10" \
  -H 'X-PAYMENT: <402-payment-token>'

Response Body 200 OK

{
  "flips": ["heads", "tails", "heads", "heads", "tails", "tails", "heads", "tails", "heads", "heads"],
  "heads": 6,
  "tails": 4,
  "proof": {
    "round": 21543892,
    "signature": "95a9...",
    "chainHash": "52db9b...",
    "timestamp": "2026-03-20T10:00:00Z"
  }
}