Skip to main content
POST
Place the previewed order (step 2 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.

Body

application/json

The only accepted body of an execute operation. The token comes from the matching preview, is valid 5 minutes and is bound to this user, key, action and parameters.

confirm_token
string
required
Example:

"oc1.eyJhIjoicGxhY2Vfb3JkZXIi….B7BIlLpN9gqCD8Ug2FcGEg"

Response

The filled order

order
object
required
price_locked
boolean
required

true when the preview's 60-second lock was still live and the fill matched it. false means the order filled at the market instead.

previewed
object
required

The numbers the user confirmed, for comparison.

replayed
boolean
required

true when this token had already been executed and the original order is being returned.