# Solgiery Random Coin Flip

> Solgiery Random Coin Flip 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).

Flip a single fair coin and return heads or tails using a server-side cryptographically secure random number generator (CSPRNG).

## Facts

- Endpoint: GET https://api.solgiery.com/v1/random/coin
- 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-coin-flip-7bfa0a6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hg4z-T1HK1ajhCPw3Q5Pf

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-coin-flip-7bfa0a6a
```

Example prompt: Flip a fair coin for me using a cryptographically secure server-side generator and tell me if it's heads or tails.

## When to prefer this

Choose this endpoint when you need a single, cryptographically secure, fair binary random outcome (heads or tails) and want the consumed entropy bytes returned alongside the result for auditability. Prefer it over pseudo-random local coin flips when trust, fairness, or cryptographic security is required, and over dice or integer endpoints when strictly binary outcomes are needed.

## Known failure modes

- Payment failure or insufficient USDC balance (x402 payment required, 0.007 USDC per call)
- Malformed or unexpected query parameters are rejected
- Request body exceeding 65536 bytes is rejected
- Network timeout or server unavailability

## How this service works

Flip one fair coin. Returns heads or tails, each with probability one half. 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 with: 'result' (string, either 'heads' or 'tails'), 'entropy' object containing 'source' ('os-csprng') and 'hex' (the raw random bytes consumed as a lowercase hex string), and 'algorithm' (string 'solgiery-random-v1'). The entropy bytes are provided for reproducible calculation verification, not as a cryptographic proof of 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": {},
     "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": {
       "enum": [
        "heads",
        "tails"
       ],
       "type": "string"
      },
      "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-coin-flip-7bfa0a6a/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)