---
title: "Pin the drand beacon value (random.v1 only)"
method: POST
path: "/v1/deals/{id}/entropy"
tags: ["deals"]
---

# Pin the drand beacon value (random.v1 only)

`POST /v1/deals/{id}/entropy`

## Request

- Base URL: `https://api.redeal.dev`
- URL: `https://api.redeal.dev/v1/deals/{id}/entropy`
- Auth: HTTP bearer

Once all reveals are in, the server fetches the deal's pre-declared drand round from the public League of Entropy beacon (quicknet), pins the value, computes the draw, and issues the certificate. Callers never supply the value, so nobody can choose entropy. Idempotent: repeat calls after COMPUTED report the result.

## Path parameters

- `id` string, required

## Response `200`

Beacon value pinned; deal COMPUTED with result, or already-computed report.

- object
  - `deal_id` string
  - `state` string
  - `result` object, nullable
  - `certificate_id` string, nullable

## Other responses

- `400`: Error. The message is instructive: it names the code and the fix.
- `401`: Error. The message is instructive: it names the code and the fix.
- `403`: Error. The message is instructive: it names the code and the fix.
- `409`: Error. The message is instructive: it names the code and the fix.
- `502`: Error. The message is instructive: it names the code and the fix.

---

[API](https://skmtc.dev/redeal-dev/apis/redeal-api.md) · [All operations](https://skmtc.dev/redeal-dev/apis/redeal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/redeal-dev/apis/redeal-api/revisions/b3685d5f93af?raw)