Withdraw Stuck UTXOs

Recover blocked (stuck) UTXOs to a public address

post

Withdraws the caller's stuck UTXOs for a token to a public recipientAddress. Authorized by a normal mode session (secp256k1 request signature via x-hinkal-request-signature header, bound to "POST /withdraw-stuck-utxos") or an EIP-712 mode session with a per-transaction EIP-712 typed-data signature (primary type WithdrawStuckUtxos) on EVM/Tron, or an ed25519 plain-text signature on Solana.

Normal mode: include x-hinkal-request-signature header; omit signature. EIP-712 mode: include signature in body; omit x-hinkal-request-signature header.

Header parameters

x-hinkal-request-signaturestringOptional

Required for normal mode sessions: hex-encoded compact secp256k1 signature secp256k1_sign(SHA256(binding + "\n" + JSON.stringify(body))), where binding is "POST <routePath>" for this endpoint. Omit for EIP-712 mode sessions — include signature in the request body instead. See Authentication for the full signing scheme.

Body

sessionIdstring · uuidRequired

Session identifier UUID from POST /create-session

noncestring · uuidRequired

Per-request UUID. Echoed back in the response.

chainIdintegerRequired

tokenAddressstringRequired

recipientAddressstringRequired

signaturestringOptional

EIP-712 or ed25519 signature (EIP-712 mode only; omit for normal mode)

Responses

200

Stuck UTXOs withdrawn

application/json

400

Validation error

application/json

401

Invalid signature or reused nonce

application/json

409

Request nonce already consumed. Each nonce is single-use; generate a fresh UUID for every request.

application/json

500

Server error

application/json

post/withdraw-stuck-utxos

POST /withdraw-stuck-utxos HTTP/1.1
Host: api.hinkal.io
Content-Type: application/json
Accept: */*
Content-Length: 236

{
  "sessionId": "ffd74231-0672-48c7-bd82-9f72a803578b",
  "nonce": "79036194-b12c-47e6-bc74-28515da043c0",
  "chainId": 10,
  "tokenAddress": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
  "recipientAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}

{
  "success": true,
  "txHashes": [
    "0x9f2b8c4a1e5d7f3b9c2a4e8f1d5b7c9a3e5f7b1d9c2a4f6e8b1c3d5a7f9e2b4"
  ],
  "nonce": "79036194-b12c-47e6-bc74-28515da043c0"
}