Skip to main content
POST
Enter an unfunded lottery before its cutoff

Authorizations

X-Ambient-Actor
string
header
required

Provisioned actor identifier.

X-Ambient-Timestamp
string
header
required

Current Unix timestamp in seconds, within the configured clock-skew window.

Authorization
string
header
required

Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256 signature. See Authentication and authority for the canonical input.

Path Parameters

marketId
string
required

Client-selected market identifier.

Minimum string length: 1

Body

application/json
commandId
string
required

Actor-scoped idempotency key. Retry the identical command with the same value.

Minimum string length: 1
principalId
string
required

Principal represented by the authenticated actor.

Minimum string length: 1
authorityRef
string

Required delegation identifier when the actor and principal differ. Omit for self-action.

Minimum string length: 1
evidenceUrl
string<uri>

Optional valid UTF-8 HTTPS URL without embedded credentials or surrounding whitespace, at most 2048 bytes. Ambient does not fetch, verify or deduplicate it.

Maximum string length: 2048

Response

Accepted entry decision; use my-outcome for the scoped entry receipt.

market
object
required
commitments
object[]
required

Commitments created or changed by the command.

events
object[]
required
bidReceipts
object[]

Amount-free receipts returned after accepted sealed bids.

auctionResolution
object

Public result produced at close or after deterministic winner promotion.

offerReceipts
object[]

Public-safe receipts returned after offer submission.

requestForOffersResolution
object