> ## 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 Undelegate Request
> Create an undelegate transaction to revoke voting from Super Representative.
## OpenAPI
````yaml POST /api/v1/tron/{network}/staking/undelegate
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/tron/{network}/staking/undelegate:
post:
tags:
- TRON
summary: Create Undelegate Request
description: >-
Create an undelegate transaction to revoke voting from Super
Representative.
operationId: tron-staking-undelegate
parameters:
- name: network
required: true
in: path
description: >-
TRON network:
- `mainnet` — TRON
mainnet.
- `testnet-nile` — TRON testnet.
schema:
enum:
- mainnet
- testnet-nile
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TronUndelegateRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/SuccessResponse'
- type: object
properties:
result:
$ref: '#/components/schemas/TronUndelegateResponse'
'400':
description: Bad request
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/ExceptionResponse'
- type: object
properties:
error:
oneOf:
- $ref: '#/components/schemas/TronInvalidResourceException'
- $ref: >-
#/components/schemas/TronInvalidUnfreezeAmountException
- $ref: >-
#/components/schemas/TronInsufficientUnfreezeBalanceException
- $ref: >-
#/components/schemas/TronUndelegateTransactionException
examples:
InvalidResourceException:
value:
error:
code: 125108
message: >-
Invalid resource type specified. Supported values are
"ENERGY" and "BANDWIDTH".
name: InvalidResourceException
type: client
result: null
InvalidUnfreezeAmountException:
value:
error:
code: 125105
message: >-
Unfreeze amount exceeds the available frozen balance or
is invalid. Please verify the account’s frozen amount.
name: InvalidUnfreezeAmountException
type: client
result: null
InsufficientUnfreezeBalanceException:
value:
error:
code: 125107
message: >-
Delegator is attempting to unfreeze more TRX than is
available for the specified resource. Please adjust the
unfreeze amount.
name: InsufficientUnfreezeBalanceException
type: client
result: null
UndelegateTransactionException:
value:
error:
code: 125115
message: >-
Failed to create or broadcast undelegation transaction.
Please verify the account, frozen balance, and validator
address.
name: UndelegateTransactionException
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'
security:
- bearer: []
components:
schemas:
TronUndelegateRequest:
type: object
properties:
amount:
type: integer
format: int64
description: Amount of tokens in SUN (1 TRX = 10⁶ SUN).
example: 10000000
nullable: false
delegatorAddress:
type: string
format: tron-address
description: Delegator account address.
example: TNDzfERDpxLDS2w1q6yaFC7pzqaSQ3Bg3r
nullable: false
resource:
type: string
enum:
- BANDWIDTH
- ENERGY
description: >-
Type of resources to be used for freezing TRX:- `BANDWIDTH`
— default; for regular transactions on the TRON
chain.
- `ENERGY` — for using smart contracts or running
DApps.
example: BANDWIDTH
default: BANDWIDTH
required:
- amount
- delegatorAddress
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
TronUndelegateResponse:
type: object
properties:
delegatorAddress:
type: string
format: tron-address
description: Delegator account address.
example: TNDzfERDpxLDS2w1q6yaFC7pzqaSQ3Bg3r
nullable: false
amount:
type: integer
format: int64
description: Amount of tokens in SUN (1 TRX = 10⁶ SUN).
example: 10000000
nullable: false
resource:
type: string
enum:
- BANDWIDTH
- ENERGY
description: >-
Type of resources used for processing the freeze transaction:
`BANDWIDTH` or `ENERGY`.
example: ENERGY
unsignedTransaction:
type: object
description: Original unsigned transaction object returned by tronWeb.
additionalProperties: false
unsignedTransactionSerialized:
type: string
description: >-
Unsigned serialized transaction in Base64 encrypted format ready for
signing.
example: eyJ0eElEIjoidHJ4SWQifQ==
createdAt:
type: string
description: Timestamp of the transaction in the ISO 8601 format.
example: '2025-06-03T12:00:00.000Z'
readOnly: true
voteAccount:
type: string
description: Vote account address used in the TRON staking flow.
example: TXYZ...abc
required:
- delegatorAddress
- amount
- resource
- unsignedTransaction
- unsignedTransactionSerialized
- createdAt
- voteAccount
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
TronInvalidResourceException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 125108
example: 125108
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
Invalid resource type specified. Supported values are "ENERGY" and
"BANDWIDTH".
example: >-
Invalid resource type specified. Supported values are "ENERGY" and
"BANDWIDTH".
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: InvalidResourceException
example: InvalidResourceException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- errors
- name
TronInvalidUnfreezeAmountException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 125105
example: 125105
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
Unfreeze amount exceeds the available frozen balance or is invalid.
Please verify the account’s frozen amount.
example: >-
Unfreeze amount exceeds the available frozen balance or is invalid.
Please verify the account’s frozen amount.
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: InvalidUnfreezeAmountException
example: InvalidUnfreezeAmountException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- errors
- name
TronInsufficientUnfreezeBalanceException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 125107
example: 125107
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
Delegator is attempting to unfreeze more TRX than is available for
the specified resource. Please adjust the unfreeze amount.
example: >-
Delegator is attempting to unfreeze more TRX than is available for
the specified resource. Please adjust the unfreeze amount.
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: InsufficientUnfreezeBalanceException
example: InsufficientUnfreezeBalanceException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- errors
- name
TronUndelegateTransactionException:
type: object
properties:
type:
type: string
default: client
example: client
description: Exception category.
code:
type: integer
format: int32
default: 125115
example: 125115
description: Numeric error code identifying the exception type.
message:
type: string
default: >-
Failed to create or broadcast undelegation transaction. Please
verify the account, frozen balance, and validator address.
example: >-
Failed to create or broadcast undelegation transaction. Please
verify the account, frozen balance, and validator address.
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: UndelegateTransactionException
example: UndelegateTransactionException
description: Exception class name for runtime error identification.
required:
- type
- code
- message
- errors
- 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
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 Undelegate Request](/reference/monad-delegators-create-undelegation.md)
- [Withdrawal](/docs/withdrawal-restaking.md)