> ## Documentation Index
> Fetch the complete documentation index at: https://docs.p2p.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Unstaking Request
> Create an unstake request transaction.
## OpenAPI
````yaml POST /api/v1/sei/{network}/staking/unstake
openapi: 3.0.0
info:
title: Staking API
description: API used for staking
version: 1.0.0
contact: {}
servers:
- url: https://api.p2p.org/api
security:
- bearer: []
tags:
- name: Aptos
description: Aptos staking operations (stake, unstake, withdraw, claim).
- name: Celestia
description: Celestia staking operations (stake, unstake, redelegate, claim).
- name: Cosmos
description: Cosmos Hub staking operations (stake, unstake, redelegate, claim).
- name: EigenLayer
description: EigenLayer restaking operations.
- name: Ethereum
description: Ethereum staking operations (direct, SSV, pooled).
- name: Hyperliquid
description: Hyperliquid staking operations.
- name: Monad
description: Monad staking operations (delegate, undelegate, withdraw).
- name: P2P SSV
description: P2P-managed SSV validator operations (deposit, claim, withdraw).
- name: Polkadot
description: Polkadot staking and nomination pool operations.
- name: Polygon
description: Polygon staking operations.
- name: Pooled Staking
description: Pooled staking vault operations (deposit, unstake, withdraw).
- name: Sei
description: Sei staking operations (stake, unstake, redelegate, claim).
- name: Solana
description: Solana staking operations (stake, split, merge, deactivate, withdraw).
- name: SSV
description: SSV network validator operations.
- name: Story
description: Story network staking operations.
- name: Sui
description: Sui staking operations.
- name: TON
description: TON staking operations (single nominator, whales pool).
- name: TRON
description: TRON staking operations (freeze, delegate, vote, withdraw).
- name: Unified
description: Unified multi-chain staking interface.
paths:
/api/v1/sei/{network}/staking/unstake:
post:
tags:
- Sei
summary: Create Unstake Request
description: Create an unstake request transaction.
operationId: create-sei-unstake-transaction
parameters:
- name: network
required: true
in: path
description: >-
Sei network:
- `pacific-1` — Sei
mainnet.
- `atlantic-2` — Sei testnet.
schema:
enum:
- pacific-1
- atlantic-2
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/SeiStakeOrUnstakeStakingSeiRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/SuccessResponse'
- type: object
properties:
result:
$ref: >-
#/components/schemas/SeiStakeOrUnstakeTransactionStakingSeiResponse
'400':
description: Bad request
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ExceptionResponse'
- type: object
properties:
error:
oneOf:
- $ref: '#/components/schemas/CommonValidationException'
- $ref: >-
#/components/schemas/CosmosCommonCosmosNetworkIsNotIncludedInListException
- $ref: >-
#/components/schemas/AccountNotFoundStakingCosmosException
- $ref: >-
#/components/schemas/SeiEvmAddressNotAssociatedException
- $ref: >-
#/components/schemas/CosmosInsufficientFundsOnCosmosAccountException
- $ref: >-
#/components/schemas/NoDelegationForValidatorException
- $ref: >-
#/components/schemas/CosmosRedelegationTransactionInProcessException
- $ref: >-
#/components/schemas/CosmosSimulationTransactionOnCosmosException
- $ref: '#/components/schemas/InvalidTransactionException'
examples:
ValidationException:
value:
error:
code: 100101
message: >-
The data provided is not valid. Please check the request
parameters and try again.
name: ValidationException
type: client
result: null
CommonCosmosNetworkIsNotIncludedInListException:
value:
error:
code: 100101
message: >-
The request could not be performed because the network
provided is not supported. Please specify the network
from the list of available ones: undefined.
name: CommonCosmosNetworkIsNotIncludedInListException
type: client
result: null
AccountNotFoundStakingCosmosException:
value:
error:
code: 110112
message: Account on cosmos network not found
name: AccountNotFoundStakingCosmosException
type: client
result: null
SeiEvmAddressNotAssociatedException:
value:
error:
code: 133100
message: >-
EVM address is not associated with a Sei Cosmos identity
yet. Send any outbound transaction from this address
first (e.g. a 0-value self-transfer) to auto-associate
it, then retry.
name: SeiEvmAddressNotAssociatedException
type: client
result: null
InsufficientFundsOnCosmosAccountException:
value:
error:
code: 110101
message: >-
The request could not be performed because the amount of
tokens in the stash account is insufficient. Please
check the balance and specify the correct request
parameters.
name: InsufficientFundsOnCosmosAccountException
type: client
result: null
NoDelegationForValidatorException:
value:
error:
code: 110115
message: >-
The request could not be performed because the specified
address has no delegation with the validator.
name: NoDelegationForValidatorException
type: client
result: null
RedelegationTransactionInProcessException:
value:
error:
code: 110114
message: >-
The request could not be performed because the
redelegation to this validator is already in progress.
Please try again after the redelegation process will be
completed.
name: RedelegationTransactionInProcessException
type: client
result: null
SimulationTransactionOnCosmosException:
value:
error:
code: 110113
message: >-
The request could not be performed because the
simulation transaction failed.
name: SimulationTransactionOnCosmosException
type: client
result: null
InvalidTransactionException:
value:
error:
code: 110117
message: Broadcast transaction invalid. undefined
name: InvalidTransactionException
type: client
result: null
'401':
description: Unauthorized
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ExceptionResponse'
- type: object
properties:
error:
oneOf:
- $ref: '#/components/schemas/AuthNoTokenException'
- $ref: '#/components/schemas/AuthWrongTokenException'
examples:
NoTokenException:
value:
error:
code: 101111
message: >-
No Bearer token has been provided. To obtain an
authentication token, follow the instructions at
https://docs.p2p.org/docs/authentication.
name: NoTokenException
type: authentication
result: null
WrongTokenException:
value:
error:
code: 101109
message: >-
An invalid Bearer token has been provided. Please
specify the correct authentication token.
name: WrongTokenException
type: authentication
result: null
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
description: Internal server error
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ExceptionResponse'
- type: object
properties:
error:
$ref: >-
#/components/schemas/CosmosCreateUnstakeTransactionException
examples:
CreateUnstakeTransactionException:
value:
error:
code: 110104
message: >-
The staking request transaction could not be created
because the internal server error occurred.
name: CreateUnstakeTransactionException
type: server
result: null
security:
- bearer: []
components:
schemas:
SeiStakeOrUnstakeStakingSeiRequest:
type: object
properties:
stashAccountAddress:
type: string
description: Delegator account address which keeps tokens.
pattern: (^sei[a-z0-9]{39}$|^0x[0-9a-fA-F]{40}$)
memo:
type: string
example: This is your memo message
deprecated: true
description: >-
Deprecated: EVM precompile transactions do not support memo. Field
is accepted but ignored.
amount:
type: number
format: double
description: Amount of tokens to stake or unstake in SEI.
required:
- stashAccountAddress
- amount
SuccessResponse:
type: object
properties:
error:
type: object
nullable: true
default: null
description: Error object. Always null on successful responses.
result:
type: object
description: Response payload containing the requested data.
description: Standard API success response envelope wrapping the result payload.
required:
- error
- result
SeiStakeOrUnstakeTransactionStakingSeiResponse:
type: object
properties:
stashAccountAddress:
type: string
description: Delegator stash account address (sei1... or 0x...).
pattern: (^sei[a-z0-9]{39}$|^0x[0-9a-fA-F]{40}$)
transactionData:
description: EVM transaction fields for signing.
allOf:
- $ref: '#/components/schemas/SeiEvmTransactionData'
createdAt:
type: string
format: date-time
description: Timestamp of the transaction in ISO 8601 format.
readOnly: true
amount:
type: number
format: double
description: Amount of tokens.
currency:
type: string
enum:
- sei
- usei
- msei
description: >-
Currency of the tokens:
- `sei` — Sei native staking
token.
- `usei` — 1 SEI = 10⁶ uSEI.
- `msei` — 1 SEI =
10³ mSEI.
validatorAddress:
type: string
description: Validator address to which tokens are delegated.
example: seivaloperjj5m7nku1ZlgyUJJ5kH1Rln3bER6eWHAKwKsgC9
pattern: ^seivaloper[a-zA-Z0-9]{39}$
required:
- stashAccountAddress
- transactionData
- createdAt
- amount
- currency
- validatorAddress
ExceptionResponse:
type: object
properties:
error:
type: object
description: Error object containing exception details. Null on success.
result:
type: object
nullable: true
default: null
description: Result payload. Always null on error responses.
requestId:
type: string
description: >-
Identifier of the request (the `x-request-id` header). Quote this
value to correlate the response with server logs.
example: 90c16e9e-6e99-4651-a033-60290356df2f
timestamp:
type: string
format: date-time
description: ISO 8601 timestamp of when the error response was generated.
example: '2026-05-20T22:29:03.126Z'
description: Standard API error response envelope wrapping the exception details.
required:
- error
- result
- timestamp
CommonValidationException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 100101
example: 100101
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
The data provided is not valid. Please check the request parameters
and try again.
example: >-
The data provided is not valid. Please check the request parameters
and try again.
description: Human-readable error message describing what went wrong.
errors:
description: Validation error details when applicable.
type: array
items:
$ref: '#/components/schemas/ValidationErrorResponse'
name:
type: string
default: ValidationException
example: ValidationException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- errors
- name
CosmosCommonCosmosNetworkIsNotIncludedInListException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 115101
example: 115101
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
The request could not be performed because the network provided is
not supported. Please specify the network from the list of available
ones: cosmoshub-4, celestia-mainnet-beta, celestia-mocha-testnet,
pacific-1, atlantic-2.
example: >-
The request could not be performed because the network provided is
not supported. Please specify the network from the list of available
ones: cosmoshub-4, celestia-mainnet-beta, celestia-mocha-testnet,
pacific-1, atlantic-2.
description: Human-readable error message describing what went wrong.
name:
type: string
default: CommonCosmosNetworkIsNotIncludedInListException
example: CommonCosmosNetworkIsNotIncludedInListException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
AccountNotFoundStakingCosmosException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 110112
example: 110112
description: Numeric error code identifying the exception type.
message:
type: string
default: Account on cosmos network not found
example: Account on cosmos network not found
description: Human-readable error message describing what went wrong.
name:
type: string
default: AccountNotFoundStakingCosmosException
example: AccountNotFoundStakingCosmosException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
SeiEvmAddressNotAssociatedException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 133100
example: 133100
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
EVM address is not associated with a Sei Cosmos identity yet. Send
any outbound transaction from this address first (e.g. a 0-value
self-transfer) to auto-associate it, then retry.
example: >-
EVM address is not associated with a Sei Cosmos identity yet. Send
any outbound transaction from this address first (e.g. a 0-value
self-transfer) to auto-associate it, then retry.
description: Human-readable error message describing what went wrong.
name:
type: string
default: SeiEvmAddressNotAssociatedException
example: SeiEvmAddressNotAssociatedException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
CosmosInsufficientFundsOnCosmosAccountException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 110101
example: 110101
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
The request could not be performed because the amount of tokens in
the stash account is insufficient. Please check the balance and
specify the correct request parameters.
example: >-
The request could not be performed because the amount of tokens in
the stash account is insufficient. Please check the balance and
specify the correct request parameters.
description: Human-readable error message describing what went wrong.
name:
type: string
default: InsufficientFundsOnCosmosAccountException
example: InsufficientFundsOnCosmosAccountException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
NoDelegationForValidatorException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 110115
example: 110115
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
The request could not be performed because the specified address has
no delegation with the validator.
example: >-
The request could not be performed because the specified address has
no delegation with the validator.
description: Human-readable error message describing what went wrong.
name:
type: string
default: NoDelegationForValidatorException
example: NoDelegationForValidatorException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
CosmosRedelegationTransactionInProcessException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 110114
example: 110114
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
The request could not be performed because the redelegation to this
validator is already in progress. Please try again after the
redelegation process will be completed.
example: >-
The request could not be performed because the redelegation to this
validator is already in progress. Please try again after the
redelegation process will be completed.
description: Human-readable error message describing what went wrong.
name:
type: string
default: RedelegationTransactionInProcessException
example: RedelegationTransactionInProcessException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
CosmosSimulationTransactionOnCosmosException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 110113
example: 110113
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
The request could not be performed because the simulation
transaction failed.
example: >-
The request could not be performed because the simulation
transaction failed.
description: Human-readable error message describing what went wrong.
name:
type: string
default: SimulationTransactionOnCosmosException
example: SimulationTransactionOnCosmosException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
InvalidTransactionException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 110117
example: 110117
description: Numeric error code identifying the exception type.
message:
type: string
default: Broadcast transaction invalid. %s
example: Broadcast transaction invalid. %s
description: Human-readable error message describing what went wrong.
name:
type: string
default: InvalidTransactionException
example: InvalidTransactionException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
AuthNoTokenException:
type: object
properties:
type:
type: string
default: authentication
example: authentication
description: Exception category.
code:
type: integer
format: int32
default: 101111
example: 101111
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
No Bearer token has been provided. To obtain an authentication
token, follow the instructions at
https://docs.p2p.org/docs/authentication.
example: >-
No Bearer token has been provided. To obtain an authentication
token, follow the instructions at
https://docs.p2p.org/docs/authentication.
description: Human-readable error message describing what went wrong.
name:
type: string
default: NoTokenException
example: NoTokenException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
AuthWrongTokenException:
type: object
properties:
type:
type: string
default: authentication
example: authentication
description: Exception category.
code:
type: integer
format: int32
default: 101109
example: 101109
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
An invalid Bearer token has been provided. Please specify the
correct authentication token.
example: >-
An invalid Bearer token has been provided. Please specify the
correct authentication token.
description: Human-readable error message describing what went wrong.
name:
type: string
default: WrongTokenException
example: WrongTokenException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
CosmosCreateUnstakeTransactionException:
type: object
properties:
type:
type: string
default: server
example: server
description: Exception category.
code:
type: integer
format: int32
default: 110104
example: 110104
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
The unstake request transaction could not be created because the
internal server error occurred.
example: >-
The unstake request transaction could not be created because the
internal server error occurred.
description: Human-readable error message describing what went wrong.
name:
type: string
default: CreateUnstakeTransactionException
example: CreateUnstakeTransactionException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- name
SeiEvmTransactionData:
type: object
properties:
to:
type: string
description: Precompile contract address.
value:
type: string
description: Value in wei (string to preserve precision).
data:
type: string
description: ABI-encoded calldata.
gasLimit:
type: string
description: Gas limit estimate.
gasPrice:
type: string
description: Gas price in wei.
nonce:
type: number
description: Transaction nonce.
chainId:
type: number
description: EVM chain ID (pacific-1=1329, atlantic-2=1328).
unsignedTransaction:
type: string
description: >-
RLP-encoded unsigned transaction hex. Sign this with
eth_signTransaction.
required:
- to
- value
- data
- gasLimit
- gasPrice
- nonce
- chainId
- unsignedTransaction
ValidationErrorResponse:
type: object
properties:
property:
type: string
description: Name of the property that failed validation.
constraints:
type: object
additionalProperties:
type: string
description: Validation constraint details describing what was expected.
required:
- property
- constraints
responses:
TooManyRequests:
description: >-
Too Many Requests — the client exceeded its rate limit. The response
advertises when to retry and the active quota via headers.
headers:
Retry-After:
description: Number of seconds to wait before retrying the request.
schema:
type: integer
example: 60
RateLimit-Limit:
description: >-
The request quota (maximum number of requests) for the most
restrictive applicable window.
schema:
type: integer
example: 120
RateLimit-Reset:
description: >-
Number of seconds until the rate-limit window resets and requests
are accepted again.
schema:
type: integer
example: 60
RateLimit-Policy:
description: >-
The active rate-limit policy as `;w=`,
comma-separated when multiple windows apply.
schema:
type: string
example: 120;w=60
content:
application/json:
schema:
type: object
properties:
error:
type: object
properties:
code:
type: integer
name:
type: string
example: ThrottlerException
message:
type: string
example: ThrottlerException
errors:
type: array
nullable: true
items:
type: object
result:
type: object
nullable: true
example: null
requestId:
type: string
description: >-
Identifier of the request (the `x-request-id` header). Quote
this value to correlate the response with server logs.
example: 90c16e9e-6e99-4651-a033-60290356df2f
timestamp:
type: string
format: date-time
description: ISO 8601 timestamp of when the error response was generated.
example: '2026-05-20T22:29:03.126Z'
securitySchemes:
bearer:
scheme: bearer
bearerFormat: JWT
type: http
````
## Related topics
- [Create Unstaking Request](/reference/create-cosmos-unstake-transaction.md)
- [The Graph](/docs/unified-api-the-graph.md)
- [Aptos](/docs/unified-api-aptos.md)
- [Tezos](/docs/unified-api-tezos.md)