Skip to main content
POST
/
prepare-transactions
/
newInvest
newInvest
curl --request POST \
  --url https://api.sandbox.brickken.com/prepare-transactions/newInvest \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "method": "newInvest",
  "chainId": "aa36a7",
  "tokenSymbol": "EXMPL",
  "investorEmail": "investor@example.com",
  "investorAddress": "0x1111111111111111111111111111111111111111",
  "investmentAmount": "1000",
  "paymentTokenSymbol": "USDT"
}
'
{
  "transactions": [
    {}
  ],
  "txId": "<string>"
}
Prepares unsigned transactions for making an investment in a Security Token Offering (STO). This endpoint is equivalent to calling /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

Authorizations

​
x-api-key
string
header
required

Body

application/json

Request body for newInvest. signerAddress is optional when investorAddress signs the transaction.

​
method
enum<string>
required

Required. Must be newInvest.

Available options:
newInvest
​
chainId
string
required

Required. Blockchain network identifier. Hex format is recommended, for example Sepolia aa36a7.

​
tokenSymbol
string
required

Required. Token symbol. Must be 2 to 5 uppercase letters or numbers.

​
investorEmail
string<email>
required

Required. Investor email.

​
investorAddress
string
required

Required. Investor wallet address. Used as signerAddress when signerAddress is omitted.

Pattern: ^0x[a-fA-F0-9]{40}$
​
investmentAmount
string
required

Required. Payment-token amount to invest.

​
signerAddress
string

Optional. Wallet address that will sign the prepared transaction. If omitted, the API uses investorAddress for this method.

​
paymentTokenSymbol
string

Optional. Payment token symbol. If omitted, the chain default payment token is used.

​
gasLimit
string

Optional. Gas limit override. If omitted, the API estimates gas automatically.

​
privateRpcUrl
string

Optional. Private RPC URL override. If omitted, the API uses the configured RPC for chainId.

​
nonce
integer

Optional. Nonce override. If omitted, the API reads the pending nonce from the RPC.

Response

200 - application/json

Successful response

​
transactions
object[]
required
​
txId
string
required