latestOpenAPI 3.0.32026-08-10161240.1 KB

5d4ce7cb355d

Draws

Create, add entries, and seal in one call

The recommended endpoint when you already have the full entrant list. With wait: true, blocks until the drand round arrives (~32–35 s with quicknet defaults) and returns the resolved draw with the winner. If create + entries succeed but the seal step fails, the open draw and tickets are returned with HTTP 500 / code: seal_failed — retry via POST /v1/draws/{id}/seal.

post/v1/draws/instant

Request body

namestring required

descriptionstring nullable

direction'winner' | 'loser'

winner_countinteger

Multi-winner draws are enterprise-only in v1.

drand_chain'quicknet' | 'classic'

callback_urlstring nullable

Webhook target for draw.sealed / draw.resolved / draw.cancelled events.

metadataobject nullable

Opaque

round_offset_secondsinteger

waitboolean

Response

Draw sealed (and resolved, when wait was true and the round arrived in time).

successboolean

messagestring

Example response

{
  "success": true,
  "data": {
    "draw": {
      "id": "K7M2"
    }
  }
}