Skip to main content
POST
Create Stake

Authorizations

Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

X-DFNS-USERACTION
string
header
required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Body

application/json
protocol
enum<string>
required
Available options:
Ethereum
walletId
string
required

Id of the Dfns wallet making the deposit.

Required string length: 1 - 64
Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

provider
enum<string>
required

Staking Provider

Available options:
Figment
amount
string
required

Transaction amount denominated in min units

Pattern: ^\d+$
externalId
string

Response

200 - application/json

Success

id
string
required
Required string length: 1 - 64
Pattern: ^stk-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"stk-0pmu3-tog2k-fdtn0teii2i4r13f"

walletId
string
required

Wallet id.

Required string length: 1 - 64
Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

status
enum<string>
required

Status of the stake position.

Available options:
Active,
Failed,
Staking,
Unbonding,
Unbond,
Withdrawing,
Withdrawn
requester
object
required

The user who initiated the request.

requestBody
Babylon · object
required
dateCreated
string<date-time>
required

ISO 8601 date (must be UTC). When the stake was created.

Example:

"2023-04-14T20:41:28.715Z"

protocol
enum<string>
required
Available options:
Babylon
data
object
required
actions
object[]
required
provider
enum<string>

The staking infrastructure provider used to manage the stake.

Available options:
Figment
Last modified on July 20, 2026