Seeded dice roll API

Rolls dice from NdM+K notation (or count/sides) deterministically from a seed, returning each die and the modified total. The value-add: reproducible RPG/game rolls with full dice-notation parsing. Answers 'Roll 3d6+2 deterministically', 'How do I parse and roll dice notation?'.

Price$0.01per request

MethodPOST

Route/v1/generate/dice-roll

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

dicerollrpgnotationdeterministicseedcoingenerate

API URLhttps://x402.hexl.dev/v1/generate/dice-roll

Integration docs

Example request

{
  "notation": "3d6+2",
  "seed": "abc"
}

Example response

{
  "rolls": [
    4,
    4,
    1
  ],
  "sides": 6,
  "count": 3,
  "modifier": 2,
  "total": 11,
  "notation": "3d6+2",
  "seed": "abc",
  "deterministic": true,
  "interpretation": "Reproducible dice roll: 3d6+2 = 11."
}

Input schema

{
  "type": "object",
  "required": [
    "seed"
  ],
  "properties": {
    "notation": {
      "type": "string",
      "examples": [
        "3d6+2",
        "d20",
        "2d6"
      ]
    },
    "sides": {
      "type": "integer",
      "minimum": 2,
      "examples": [
        6
      ]
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "examples": [
        3
      ]
    },
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "examples": [
        "abc"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}