Skip to main content
POST
/
prepare-transactions
/
newSto
newSto
curl --request POST \
  --url https://api.sandbox.brickken.com/prepare-transactions/newSto \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "method": "newSto",
  "signerAddress": "<string>",
  "chainId": "<string>",
  "tokenizerEmail": "<string>",
  "tokenAmount": "<string>",
  "offeringName": "<string>",
  "startDate": "2023-11-07T05:31:56Z",
  "endDate": "2023-11-07T05:31:56Z",
  "acceptedCoin": "<string>",
  "minRaiseUSD": "<string>",
  "maxRaiseUSD": "<string>",
  "minInvestment": "<string>",
  "maxInvestment": "<string>"
}'
{
  "transactions": [
    {}
  ],
  "txId": "<string>"
}
Prepares unsigned transactions for creating a new Security Token Offering (STO). This endpoint is equivalent to calling /prepare-transactions with method=newSto.

​
Request Body

ParameterTypeRequiredDescription
signerAddressstringYesAddress that will sign the transaction
chainIdstringYesBlockchain network identifier (hex format)
methodstringYesTransaction method type (should be “newSto”)
tokenSymbolstringYesSymbol of the token for the STO
paymentTokenSymbolstringYesSymbol of the payment token
pricestringYesPrice per token
minInvestmentstringYesMinimum investment amount
maxInvestmentstringYesMaximum investment amount
startDatestringYesSTO start date (ISO format)
endDatestringYesSTO end date (ISO format)
tokenizerEmailstringYesEmail of the tokenizer

​
Example Request

{
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "chainId": "aa36a7",
  "method": "newSto",
  "tokenSymbol": "PROP1",
  "paymentTokenSymbol": "USDT",
  "price": "1.0",
  "minInvestment": "1000",
  "maxInvestment": "50000",
  "startDate": "2024-01-01T00:00:00Z",
  "endDate": "2024-12-31T23:59:59Z",
  "tokenizerEmail": "tokenizer@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"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Request body for newSto method.

​
method
string

The operation to be performed.

Example:

"newSto"

​
signerAddress
string
​
chainId
string
​
tokenizerEmail
string
​
tokenAmount
string
​
offeringName
string
​
startDate
string<date-time>
​
endDate
string<date-time>
​
acceptedCoin
string
​
minRaiseUSD
string
​
maxRaiseUSD
string
​
minInvestment
string
​
maxInvestment
string

Response

200 - application/json

Successful response

​
transactions
object[]
required
​
txId
string
required