Skip to main content
POST
Preview a 100-coin order (step 1 of 2)

Authorizations

Authorization
string
header
required

Personal API key issued per SeeSaw user account: Authorization: Bearer sspat_…. Manage keys on the app API (/v1/users/me/api-keys). Revocation propagates within ~60 seconds (validation cache window).

The key's scopes decide what it may do: every key has read; a key created with ["read","write"] may also use the six write operations (marked x-required-scope: write in this document). Scopes are fixed at creation — to gain write access, create a new key. A read-only key calling a write operation gets 403 FORBIDDEN_SCOPE.

Path Parameters

id
string<uuid>
required

Topic UUID.

Body

application/json
option_id
string<uuid>
required

The option to stake on, from the topic's options.

Response

The preview (check can_place before confirming)

can_place
boolean
required
summary
object
required

What the user confirms before POST /orders. payout_if_correct_rubies equals the order's units — the rubies received if the option wins; the 100-coin stake is not returned.

reason
enum<string>

Present only when can_place is false.

Available options:
TOPIC_CLOSED,
ALREADY_STAKED,
INSUFFICIENT_BALANCE,
MECHANISM_UNSUPPORTED
confirm_token
string

Present only when can_place is true.

expires_at
string<date-time>

Present only when can_place is true. 5 minutes out.