---
title: "Build unsigned stake transaction for Blueprint validator"
method: POST
path: "/api/v1/stake/transaction"
tags: ["Staking"]
---

# Build unsigned stake transaction for Blueprint validator

`POST /api/v1/stake/transaction`

## Request

- Base URL: `https://solentic.theblueprint.xyz`
- URL: `https://solentic.theblueprint.xyz/api/v1/stake/transaction`
- Auth: none required

Creates an unsigned transaction that creates a new stake account, initializes it with the wallet as both stake and withdraw authority, and delegates to Blueprint validator. The transaction is partially signed by an ephemeral stake account keypair. The wallet owner must sign and submit. Zero private key exposure.

## Request body

- StakeRequest
  - `walletAddress` string, required: Solana wallet address (base58)
  - `amountSol` number, required: Amount of SOL to stake

## Response `200`

Unsigned transaction

- TransactionResponse
  - `transaction` string: Base64 encoded unsigned transaction
  - `stakeAccountAddress` string: New stake account address (only for create stake)
  - `message` string: Human/agent-readable instruction
  - `signers` string[]: Public keys that need to sign
  - `estimatedFeeSol` number: Estimated network fee in SOL (0.00001 for stake, 0.000005 for unstake/withdraw)
  - `expiresAt` string, date-time: ISO 8601 timestamp when this transaction expires (~60s after creation). Solana blockhashes are short-lived — sign and submit before this time or request a new transaction.
  - `epochTiming` EpochTiming: Current epoch timing information with estimated end time
    - `currentEpoch` integer: Current Solana epoch number
    - `slotsRemaining` integer: Slots remaining in current epoch
    - `estimatedSecondsRemaining` integer: Estimated seconds until epoch end
    - `estimatedEpochEnd` string, date-time: Estimated epoch end timestamp
    - `note` string: Explanation of epoch timing relevance
  - `warnings` string[]: Warnings including blockhash expiry and balance checks
  - `rewardsEstimate` object: Estimated staking rewards (included in stake transaction responses when epoch timing is available)
    - `note` string
    - `estimatedAnnualSol` number: Estimated annual reward in SOL
    - `estimatedPerEpochSol` number: Estimated reward per epoch in SOL
    - `basedOnApy` string: APY rate used for the estimate
  - `_meta` ResponseMeta: Navigation metadata included in most responses
    - `endpoint` string: The endpoint that generated this response
    - `description` string: Brief description of the response
    - `timestamp` string, date-time: ISO 8601 timestamp when this response was generated
    - `relatedEndpoints` object: Related REST endpoints for next actions
    - `relatedTools` object: Related MCP tool names (MCP responses only)
    - `nextSteps` object: Contextual next steps based on response data
    - `verifyThisCode` string: Endpoint to verify code integrity
    - `cacheTtlSeconds` integer: Cache TTL for this response
    - `documentation` string: Link to documentation
    - `support` object: Optional donation info — Blueprint is free, donation-supported infrastructure
      - `address` string: Solana address for donations
      - `message` string: Context about why donations help
      - `donate` string: How to build a donation transaction via API/MCP

## Other responses

- `400`: Validation error (invalid address, amount below minimum)
- `429`: Rate limited — 100 requests per 60-second sliding window
- `500`: Internal server error
- `502`: Solana RPC unavailable

---

[API](https://skmtc.dev/theblueprint/apis/blueprint-staking-api.md) · [All operations](https://skmtc.dev/theblueprint/apis/blueprint-staking-api/llms.txt) · [OpenAPI document](https://skmtc.dev/theblueprint/apis/blueprint-staking-api/revisions/326d6015b851?raw)