Skip to main content
POST
Withdraw Savings
Complete Withdrawal: Closes an active investment and returns the principal plus earned interest to the agent’s wallet.

Request Headers

string
required
Your API key for authentication
string
required
Must be set to application/json

Request Body

string
required
The short ID or UUID of the investment

Response

boolean
Whether the withdrawal was successful
string
Information about the withdrawal
object
object
string
The ID of the agent that owned the investment
string
New balance of the agent after the withdrawal

Status Codes

Active Investments Only: Only investments with an ā€œactiveā€ status can be withdrawn. Attempting to withdraw completed or cancelled investments will result in an error.
Interest Calculation: Interest is calculated up to the exact moment of withdrawal, including partial days.
Blockchain Confirmation: The transaction may take a few moments to be confirmed on the blockchain before the funds appear in the agent’s wallet.