Overview
The Brickken Dapp API is the API-key authenticated surface for tokenized asset workflows. Use it when your integration owns a Brickken API key and wants to prepare transactions for a wallet to sign, submit signed transactions, or read tokenization and STO data.
Use the Agentic API , MCP , or CLI for private-key based agentic flows.
Base URLs
Environment Base URL Sandbox https://api.sandbox.brickken.comProduction https://api.brickken.com
Authentication
Send your API key in every request:
x-api-key : YOUR_BRICKKEN_API_KEY
Request a key from tech@brickken.com with the email tied to your Brickken account.
Postman Collection Download the official Postman collection and environments to explore every endpoint with ready-to-run example requests.
Transaction Flow
Most write operations use the same three-step flow:
Prepare unsigned transactions with POST /prepare-transactions.
Sign every returned transaction with the wallet matching signerAddress.
Send the signed payloads with POST /send-transactions, then poll GET /get-transaction-status.
curl --request POST 'https://api.sandbox.brickken.com/prepare-transactions' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_BRICKKEN_API_KEY' \
--data '{
"chainId": "11155111",
"method": "newTokenization",
"tokenizerEmail": "issuer@example.com",
"signerAddress": "0xYourWallet",
"tokenName": "Example Asset",
"tokenSymbol": "EXMPL",
"tokenType": "RWA_TOKEN",
"supplyCap": "1000000",
"url": "https://example.com/token-docs"
}'
The response includes txId and transactions. Sign the transaction or transactions locally, then send them:
curl --request POST 'https://api.sandbox.brickken.com/send-transactions' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_BRICKKEN_API_KEY' \
--data '{
"txId": "0xPreparedTransactionId",
"signedTransactions": ["0xSignedRawTransaction"]
}'
Write Endpoints
Endpoint Purpose POST /prepare-transactionsPrepare any supported transaction method by passing method in the JSON body. POST /prepare-transactions/newTokenizationPrepare a new tokenized asset. POST /prepare-transactions/mintTokenPrepare token minting. POST /prepare-transactions/whitelistPrepare whitelist updates. POST /prepare-transactions/burnTokenPrepare token burning. POST /prepare-transactions/transferFromPrepare allowance-based token transfer. POST /prepare-transactions/transferToPrepare direct token transfer. POST /prepare-transactions/approvePrepare allowance approval. POST /prepare-transactions/dividendDistributionPrepare dividend distribution. POST /prepare-transactions/newStoPrepare a Security Token Offering. POST /prepare-transactions/newInvestPrepare an STO investment. POST /prepare-transactions/claimTokensPrepare token claims from an STO. POST /prepare-transactions/closeOfferPrepare an STO close operation. POST /send-transactionsSubmit signed transactions returned by prepare. PATCH /patch-token-docsUpdate token documentation and branding files.
Supported Methods
Area method valuesTokenization newTokenization, mintToken, whitelist, burnToken, transferFrom, transferTo, approve, dividendDistributionSTOs newSto, newInvest, claimTokens, closeOffer
Read Endpoints
Endpoint Purpose GET /get-network-infoRead chain metadata and supported network configuration. GET /get-token-infoRead token information by symbol or chain. GET /get-tokenizer-infoRead tokenizer account information. GET /get-stosList STOs for a token. GET /get-sto-by-idRead one STO by ID. GET /get-investments-by-sto-idList investments for one STO. GET /get-investor-infoRead investor status by token and email. GET /get-allowanceRead allowance between owner and spender. GET /get-balance-whitelistRead investor balance and whitelist status. GET /get-whitelist-statusCheck whether an investor wallet is whitelisted. GET /get-sto-balanceRead STO balance and status. GET /get-dividend-distributionRead dividend distribution information. GET /get-transaction-statusPoll a submitted blockchain transaction.
curl --request GET \
'https://api.sandbox.brickken.com/get-network-info?chainId=11155111' \
--header 'x-api-key: YOUR_BRICKKEN_API_KEY'
Networks
Pass chainId as decimal or hex. Client tooling normalizes common values.
Network Decimal Hex Ethereum mainnet 10x1Base mainnet 84530x2105BNB Smart Chain 560x38Polygon mainnet 1370x89Sepolia testnet 111551110xaa36a7Polygon Amoy testnet 800020x13882
Prepared transactions are on-chain actions. Verify chainId, signerAddress, token symbol or token address, and all recipient addresses before signing.