Ctrl+K

List staking requests by enterprise

get/api/staking/v1/enterprises/{enterpriseId}/requests/transactions

Retrieve staking requests and staking transactions for a given enterprise and query params.

Path Parameters

  • enterpriseIdstringRequired
    The enterprise ID.

Query Parameters

  • coinarray[string]
    Filter by one or more staking assets.
    Enum: ADA ASI ATOM AVAXC AVAXP BABY BERA BLD BSC BTC COREDAO COREUM CRONOS CSPR DOT EIGEN ETH HASH INJECTIVE MATIC NEAR OSMO POL POLYX RETH-ROCKET SEI SOMI SOL STORY STX SUI SUI:WAL TAO TIA TON TRX WETH WCT WFLR ZETA
  • walletTypestring
    Filter by Wallet Type (e.g. custodial, hot)
    Enum: cold custodial custodialPaired hot trading
  • walletIdsarray[string]
    Wallet Ids
  • permissionsstring
    Filter by user permissions
  • requestTypestring
    Filter by Staking Request Type
    Enum: STAKE UNSTAKE CLAIM_REWARDS SWITCH_VALIDATOR CHECKPOINT UNSUPPORTED
  • requestStatusarray[string]
    Filter by Staking Request status
    Enum: NEW PENDING_VALIDATORS READY PENDING_APPROVAL PENDING_BITGO_TRUST_APPROVAL PENDING FAILED REJECTED VALIDATOR_ACTIVATING PARTIAL_CONFIRMED CONFIRMED COOLDOWN WARMUP DELAYED_COOLDOWN DELAYED_WARMUP ETH_PARTIAL_EXITED ETH_EXITED
  • createdDateGtestring<date-time>
    Filter by created date greater than or equal to
  • createdDateLtstring<date-time>
    Filter by created date less than
  • searchStringstring
    Search by string match across request attributes
  • expandBuildParamsbooleanDefault: false
    Whether to expand and include full build parameters in the response.
  • pageintegerDefault: 1
    The page number for pagination.
    Minimum: >= 1
  • pageSizeintegerDefault: 20
    The page size for pagination.
    Minimum: >= 1
    Maximum: <= 100
  • sortBystringDefault: -createdDate
    Sort By field
    Enum: -createdDate createdDate

200 Response

requests
delegations array[object]
The delegations associated with this staking request.
Min items: >= 1 items
Max items: <= 1 items
transactions array[object]
The staking transactions associated with this request.
Min items: >= 1 items
Max items: <= 500 items
amount string
Amount to stake in base units.
rewardAddress string
The reward address for staking rewards.
dRepId string
The delegated representative ID.
isVoteDelegationRequest boolean
Whether this is a vote delegation request.
id string required
Staking request ID.
clientId string
Optional clientId if passed into the request.
requestingUserId string required
The ID of the user that created the staking request.
enterpriseId string required
The ID of the enterprise where the the staking request was created.
walletId string required
The ID of the wallet where the staking request was created.
walletLabel
string or null
The label of the wallet where the staking request was created.
withdrawalAddress string required
Withdrawal Address
walletType string required
The type of wallet the staking request was created from either cold, custodial, or hot.
Allowed values: cold custodial custodialPaired hot trading
type string required
The type of staking request.
Allowed values: STAKE UNSTAKE CLAIM_REWARDS SWITCH_VALIDATOR CHECKPOINT UNSUPPORTED
coin string required
The staking asset.
Allowed values: ADA ASI ATOM AVAXC AVAXP BABY BERA BLD BSC BTC COREDAO COREUM CRONOS CSPR DOT EIGEN ETH HASH INJECTIVE MATIC NEAR OSMO POL POLYX RETH-ROCKET SEI SOMI SOL STORY STX SUI SUI:WAL TAO TIA TON TRX WETH WCT WFLR ZETA
createdDate string <date-time>required
The date the staking request was created.
status string required
The status of the staking request. For ETH the status will change from NEW to READY when a validator has been assigned to the wallet's address.
Allowed values: NEW PENDING_VALIDATORS READY PENDING_APPROVAL PENDING_BITGO_TRUST_APPROVAL PENDING FAILED REJECTED VALIDATOR_ACTIVATING PARTIAL_CONFIRMED CONFIRMED COOLDOWN WARMUP DELAYED_COOLDOWN DELAYED_WARMUP ETH_PARTIAL_EXITED ETH_EXITED
statusModifiedDate string <date-time>required
The last date the status changed.
error
string or null
The reason the staking request failed.
rawError
string or null
Raw internal error message if available.
totalStaked
string or null
The sum of the amounts of all confirmed staking transactions in this request.
Example: 2000000
Match pattern: ^-?\d+$
isRestaking
boolean or null
Whether this request is a restaking operation.
propertiesOne of
page integer
The page number for paging purposes.
totalPages integer
The total number of pages for paging purposes.
totalElements integer
The number of elements per page used for paging purposes.

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

404 Response

error string
errorName string
reqId string
context object

409 Response

error string
errorName string
reqId string
context object

500 Response

error string
errorName string
reqId string
context object