> ## 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 Unstake Request > Create the unstake request transaction in the TON Whales pool. ## OpenAPI ````yaml POST /api/v1/ton/{network}/staking/ton-whales/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/ton/{network}/staking/ton-whales/unstake: post: tags: - TON summary: Create Unstake Request description: Create the unstake request transaction in the TON Whales pool. operationId: ton-staking-ton-whales-unstake parameters: - name: network required: true in: path description: >-

TON network:

schema: enum: - mainnet - testnet type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TonWhalesUnstakeRequest' responses: '200': description: OK content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessResponse' - type: object properties: result: $ref: '#/components/schemas/TonWhalesUnstakeResponse' '400': description: Bad request content: application/json: schema: allOf: - $ref: '#/components/schemas/ExceptionResponse' - type: object properties: error: oneOf: - $ref: >- #/components/schemas/TonNotFoundTonWhalesInstanceForClient - $ref: >- #/components/schemas/TonInsufficientBalanceException examples: NotFoundTonWhalesInstanceForClient: value: error: code: 121107 message: >- Not found TON whales instance. Try to make ton-whales stake first name: NotFoundTonWhalesInstanceForClient type: client result: null InsufficientBalanceException: value: error: code: 121101 message: Insufficient balance undefined name: InsufficientBalanceException type: client result: null '429': $ref: '#/components/responses/TooManyRequests' security: - bearer: [] components: schemas: TonWhalesUnstakeRequest: type: object properties: publicKey: type: string description: Public key of the nominator for the TON network. example: 7031f1dcbe0f670daf4094d04ff9a7947bc4ac9174a7d470255d1a664e20b7c6 amount: format: int64 type: integer description: >- Amount of tokens to unstake in nanoGRAMs (1 GRAM = 10⁹ nanoGRAMs, prev. nanoTONs). example: 200 walletVersion: type: string description: >- Version of the smart contract used by the wallet in the TON blockchain. example: V4 default: V4 enum: - V3R1 - V3R2 - V4 - V5R1 required: - publicKey - 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 TonWhalesUnstakeResponse: type: object properties: unsignedTransaction: type: string description: >- Unsigned transaction for the unstake request in the hexadecimal format. example: >- b5ee9c7241010101003800006b000010000000000000000001000000039fedeab7a2b56b38f19f60b5b9f70b2f1ba2d89b9c5a756036c7cfad73571fb281887735940193456f7e walletVersion: type: string description: >- Version of the smart contract used by the wallet in the TON blockchain. example: V4 enum: - V3R1 - V3R2 - V4 - V5R1 poolAddress: type: string description: Nominator pool address in the TON network. example: kQDr9Sq482A6ikIUh5mUUjJaBUUJBrye13CJiDB-R31_l7mg stakerAddress: type: string description: Main account address of the bounceable type which keeps tokens. example: '' publicKey: type: string description: Public key of the nominator for the TON network. example: 7031f1dcbe0f670daf4094d04ff9a7947bc4ac9174a7d470255d1a664e20b7c6 amount: type: string description: Amount of tokens to unstake in GRAM (prev. Toncoin). example: '2' balanceBreakdown: description: >- Balance breakdown showing active stake, pending deposit, pending withdrawal, and withdrawal-ready funds, in nanoGRAMs (prev. nanoTONs). allOf: - $ref: '#/components/schemas/TonWhalesBalanceBreakdown' required: - unsignedTransaction - walletVersion - poolAddress - stakerAddress - publicKey - amount - balanceBreakdown 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 TonNotFoundTonWhalesInstanceForClient: type: object properties: type: type: string default: client example: client description: Exception category. code: type: integer format: int32 default: 121107 example: 121107 description: Numeric error code identifying the exception type. message: type: string default: Not found TON whales instance. Try to make ton-whales stake first example: Not found TON whales instance. Try to make ton-whales stake first description: Human-readable error message describing what went wrong. name: type: string default: NotFoundTonWhalesInstanceForClient example: NotFoundTonWhalesInstanceForClient description: Exception class name for runtime error identification. required: - type - code - message - name TonInsufficientBalanceException: type: object properties: type: type: string default: client example: client description: Exception category. code: type: integer format: int32 default: 121101 example: 121101 description: Numeric error code identifying the exception type. message: type: string default: Insufficient balance example: Insufficient balance description: Human-readable error message describing what went wrong. name: type: string default: InsufficientBalanceException example: InsufficientBalanceException description: Exception class name for runtime error identification. required: - type - code - message - name TonWhalesBalanceBreakdown: type: object properties: balance: type: string description: >- Active stake currently earning rewards in the pool, in nanoGRAMs (prev. nanoTONs). example: '1000000000' pendingDeposit: type: string description: >- Pending deposit awaiting acceptance by the pool, in nanoGRAMs (prev. nanoTONs). example: '500000000' pendingWithdraw: type: string description: >- Pending withdrawal awaiting processing by the pool, in nanoGRAMs (prev. nanoTONs). example: '0' withdraw: type: string description: Funds ready for immediate withdrawal, in nanoGRAMs (prev. nanoTONs). example: '0' required: - balance - pendingDeposit - pendingWithdraw - withdraw 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 Unstake Request](/reference/unified-create-unstake-transaction.md) - [Create Unstaking Request](/reference/create-celestia-unstake-transaction.md)