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
acceptedCoinstringYesAccepted payment coin (e.g., USDT, USDC, or NATIVE)
tokenAmountstringYesTotal number of tokens offered in the STO
offeringNamestringYesName of the STO offering
minRaiseUSDstringNoMinimum raise amount in USD
maxRaiseUSDstringNoMaximum raise amount in USD
minInvestmentstringYesMinimum investment amount in payment token units
maxInvestmentstringYesMaximum investment amount in payment token units
startDatestringYesSTO start date (ISO format)
endDatestringYesSTO end date (ISO format)
tokenizerEmailstringYesEmail of the tokenizer

​
Example Request

{
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "chainId": "aa36a7",
  "method": "newSto",
  "tokenSymbol": "PROP1",
  "acceptedCoin": "USDT",
  "tokenAmount": "1000000",
  "offeringName": "Series A",
  "minRaiseUSD": "10000",
  "maxRaiseUSD": "1000000",
  "minInvestment": "1000",
  "maxInvestment": "50000",
  "startDate": "2024-01-01T00:00:00Z",
  "endDate": "2024-12-31T23:59:59Z",
  "tokenizerEmail": "[email protected]"
}

​
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