# Solgiery Random Dice Roller

> Solgiery Random Dice Roller is a paid API for AI agents from api.solgiery.com, paid per call via x402, $0.007/call, status unknown (last checked 2026-09-14).

Roll 1 to 1000 independent fair dice with a configurable number of sides using server-side CSPRNG

## Facts

- Endpoint: GET https://api.solgiery.com/v1/random/dice
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/solgiery-random-dice-roller-0d8d87a5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1tEfwDCPQKsDYY3yV-R0R

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability solgiery-random-dice-roller-0d8d87a5
```

Example prompt: Roll 3 twenty-sided dice for me using cryptographically secure randomness — I need the results for a D&D encounter.

## When to prefer this

Choose this endpoint when you need cryptographically secure, auditable dice rolls with a configurable number of sides (2–1000) and up to 1000 dice per call. It is ideal for gaming applications, simulations, or any use case requiring verifiable fair randomness with entropy bytes for auditability. Prefer over pseudo-random client-side alternatives when fairness guarantees and server-side CSPRNG provenance matter.

## Known failure modes

- count out of range (must be 1–1000) returns 400
- sides out of range (must be 2–1000) returns 400
- unknown or duplicate query parameters are rejected with 400
- null parameter values are rejected
- payment not settled via x402 returns 402 Payment Required
- request body exceeds 65536 bytes returns 400

## How this service works

Roll 1 to 1000 independent fair dice. Each result is an integer from 1 to sides inclusive; sides defaults to 6. Uses the server OS CSPRNG. Returns consumed bytes for reproducible calculation, not proof of their origin. Price: 0.007 USDC per request, including the bounded batch.

## Output

Returns a JSON object containing an array of integer dice results (one per die, each between 1 and the number of sides inclusive), an entropy object with the raw CSPRNG hex bytes consumed and the source identifier 'os-csprng', and an algorithm string 'solgiery-random-v1'. The consumed bytes are provided for reproducible audit calculations but do not prove their origin.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "count": {
       "type": "integer",
       "default": 1,
       "maximum": 1000,
       "minimum": 1
      },
      "sides": {
       "type": "integer",
       "default": 6,
       "maximum": 1000,
       "minimum": 2
      }
     },
     "description": "Unknown or duplicate parameters and null parameter values are rejected. JSON body: at most 65536 bytes, depth 16, and 4096 bytes per item. Repeated sample items together must fit 65536 bytes.",
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "algorithm",
      "result",
      "entropy"
     ],
     "properties": {
      "result": {
       "type": "array",
       "items": {
        "type": "integer",
        "maximum": 1000,
        "minimum": 1
       },
       "maxItems": 1000,
       "minItems": 1
      },
      "entropy": {
       "type": "object",
       "required": [
        "source",
        "hex"
       ],
       "properties": {
        "hex": {
         "type": "string",
         "pattern": "^([0-9a-f]{2})*$",
         "maxLength": 262144
        },
        "source": {
         "type": "string",
         "const": "os-csprng"
        }
       },
       "additionalProperties": false
      },
      "algorithm": {
       "type": "string",
       "const": "solgiery-random-v1"
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/solgiery-random-dice-roller-0d8d87a5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.solgiery.com](https://www.zero.xyz/host/api.solgiery.com/llms.txt)