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": "<string>",
  "investorAddress": "<string>",
  "tokenSymbol": "<string>",
  "investorEmail": "<string>",
  "investmentAmount": "<string>",
  "paymentTokenSymbol": "<string>"
}'
{
  "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.

​
Request Body

ParameterTypeRequiredDescription
signerAddressstringYesAddress that will sign the transaction
chainIdstringYesBlockchain network identifier (hex format)
methodstringYesTransaction method type (should be “newInvest”)
tokenSymbolstringYesSymbol of the token to invest in
paymentTokenSymbolstringYesSymbol of the payment token
amountstringYesAmount to invest
investorAddressstringYesAddress of the investor
investorEmailstringYesEmail of the investor

​
Example Request

{
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "chainId": "aa36a7",
  "method": "newInvest",
  "tokenSymbol": "PROP1",
  "paymentTokenSymbol": "USDT",
  "amount": "1000",
  "investorAddress": "0x456...",
  "investorEmail": "investor@example.com"
}

​
Response

Returns an array of unsigned transactions that need to be signed and a transaction ID for tracking. 
{
  "transactions": [
    {
      "from": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
      "to": "0xTargetAddress",
      "value": {"type": "BigNumber", "hex": "0x00"},
      "nonce": 1,
      "chainId": 11155111,
      "data": "0x...",
      "type": 2,
      "maxPriorityFeePerGas": {"type": "BigNumber", "hex": "0x..."},
      "maxFeePerGas": {"type": "BigNumber", "hex": "0x..."},
      "gasLimit": {"type": "BigNumber", "hex": "0x..."}
    }
  ],
  "txId": "unique-transaction-id"
}

​
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 method.

​
method
string

The operation to be performed.

Example:

"newInvest"

​
chainId
string
​
investorAddress
string
​
tokenSymbol
string
​
investorEmail
string
​
investmentAmount
string
​
paymentTokenSymbol
string

Response

200 - application/json

Successful response

​
transactions
object[]
required
​
txId
string
required