newInvest
Prepares the unsigned transactions that invest payment tokens in an ongoing Security Token Offering.
POST /prepare-transactions with method=newInvest.
Notes
- The investor must have sufficient balance of the payment token
- Investment amount must be within the STO’s min/max investment limits
- The STO must be active and within the investment period
- The investor address will be automatically whitelisted if required
Next step
Preparing does not touch the chain. The response gives youtxId and an array of unsigned transactions — you still have to sign and submit them.
Sign every returned transaction
signerAddress, or investorAddress for newInvest and claimTokens. It must be whitelisted by Brickken, and it needs native gas on the target chain.Submit the signed payloads
POST them to /send-transactions as { txId, signedTransactions } and Brickken broadcasts for you.If you would rather broadcast yourself, prepare with executionMode: "client-broadcast" and confirm afterwards with { txId, txHash } instead.Poll until it confirms
GET /get-transaction-status with the txId. A pending status means it is broadcast but not yet mined — do not resubmit.Authorizations
Body
Required. Operation to prepare. Must be newInvest for this endpoint.
newInvest "newInvest"
Required. Blockchain network identifier. Hex format is recommended, for example Sepolia aa36a7.
"aa36a7"
Required. Investor wallet address. It is used as the signer and sender of the prepared transactions.
^0x[a-fA-F0-9]{40}$"0x1111111111111111111111111111111111111111"
Required. Email of the investor. The investor must already exist in Brickken and be KYC eligible.
"investor@example.com"
Required. Symbol of the token being offered.
"EXMPL"
Required. Payment-token amount to invest. It must be at least the offering minimum investment.
"1000"
Optional and ignored for this method. The prepared transactions are always signed and sent by investorAddress.
"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
Optional. Symbol of the payment token used for the investment. If omitted, the chain default payment token is used.
"USDT"
Response
Successful response
Array of unsigned transaction objects ready for signing
Unique identifier for this transaction batch (required for /send-transactions). This is NOT a blockchain transaction hash.
"0x46adea7bdf49c576a760102e0d6bc9ecd650b3998588cd3d7f576a7973426aad"
Metadata about the operation