Ctrl+K

Preview and finalize staking request atomically for Go Account (internal)

post/api/go-staking/v1/internal/{coin}/accounts/{accountId}/requests/preview-and-finalize

Internal service-to-service endpoint that atomically previews (builds an unsigned OFC transaction) and finalizes a staking request in a single call. The preview payload is used internally; no signed payload is required from the caller. Bypasses user wallet permission checks. The caller must supply userId in the request body.

Path Parameters

  • coinstringRequired
    The staking asset.
    Enum: OFCSOL OFCSUI
  • accountIdstringRequired
    Account ID to fetch the staking request for.

Request Body

Internal preview+finalize request payload including userId
userId string required
The user ID on whose behalf the transaction is built
clientId
string or null
Max length: <= 256 characters
amount string <big-integer>required
Amount to stake, must be a positive value

202 Response

id string <uuid>required
clientId string
status string required
Coarse-grained status for staking requests.
Allowed values: NEW PENDING FAILED REJECTED CONFIRMED COOLDOWN WARMUP UNSUPPORTED
type string
Type of staking request. `STAKE` to delegate, `UNSTAKE` to undelegate. `UNSUPPORTED` is a fallback.
Allowed values: STAKE UNSTAKE UNSUPPORTED
Default: STAKE
coin string
goAccountId string required
error string
amount string <big-integer>required
createdDate string <date-time>required
statusModifiedDate string <date-time>
properties object required
amount string
Amount to stake or unstake, in base units
source string
Allowed values: MANUAL AUTO_STAKE

400 Response

error string
errorName string
reqId string
context object

401 Response

error string
errorName string
reqId string
context object

403 Response

error string
errorName string
reqId string
context object

500 Response

error string
errorName string
reqId string
context object