Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dfns.co/llms.txt

Use this file to discover all available pages before exploring further.

See an introduction including the list of supported providers and chains on the staking feature page, or watch the video tutorial for dashboard users.

Flow overview

1

Create a stake

Provide the wallet, provider, and amount. This implicitly creates a Stake action.POST/staking/stakes Create Stake
2

Monitor the stake

Check stake status and view earned rewards.GET/staking/stakes/{stakeId} Get StakeGET/staking/stakes/{stakeId}/rewards Get Stake Rewards
3

Manage the stake

Deposit more, Withdraw, or perform other provider-specific actions.POST/staking/stakes/{stakeId}/actions Create Stake Action
Staking rewards (APR) are dynamic and determined by real-time network conditions. Refer to the staking provider for current rates.

Stake object

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.

StatusDefinition
StakingThe stake is being created and funds are being delegated to the validator.
ActiveThe stake is active and earning rewards.
UnbondingThe stake is in the process of being unbonded (cooldown period).
UnbondThe stake has been unbonded and is ready for withdrawal.
WithdrawingThe staked funds are in the process of being withdrawn.
WithdrawnThe staked funds have been fully withdrawn.
FailedThe staking operation failed.
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
provider
enum<string>

The staking infrastructure provider used to manage the stake.

Available options:
Figment
Last modified on February 16, 2026