Skip to main content
POST
/
x402
/
token
/
create
Prepare agent ERC-20 deployment
curl --request POST \
  --url https://api.sandbox.brickken.com/x402/token/create \
  --header 'Content-Type: application/json' \
  --header 'X-Payment: <api-key>' \
  --data '
{
  "chainId": "8453",
  "signerAddress": "<string>",
  "name": "<string>",
  "symbol": "<string>",
  "agentWallet": "<string>",
  "gasLimit": "<string>",
  "nonce": 123,
  "privateRpcUrl": "<string>",
  "ownerEmail": "jsmith@example.com",
  "email": "jsmith@example.com",
  "premint": "<string>",
  "decimals": "<string>"
}
'
{
  "transactions": {},
  "txId": "<string>",
  "info": {}
}
Prepares unsigned transactions for deploying an agent-owned ERC-20 token. This facade maps to agentCreateToken.

Authentication

Omit x-api-key. If the API returns 402 Payment Required, sign the x402 payment locally and retry with X-Payment.

Key Fields

ParameterRequiredDescription
chainIdYesTarget chain ID. Decimal and hex values are accepted.
signerAddressYesWallet that signs the prepared transaction.
nameYesToken name.
symbolYesToken symbol.
agentWalletYesAgent wallet that owns or operates the token.
premintNoOptional initial token amount.
decimalsNoOptional token decimals.

Response

Returns prepared unsigned transactions and txId. If executed, use the deployment receipt to recover the deployed tokenAddress.

Authorizations

X-Payment
string
header
required

Base64-encoded x402 payment payload. Supported for x402-eligible agentic methods on /x402/... facades, /prepare-transactions, and eligible /send-transactions retries.

Body

application/json
chainId
string
default:8453
required

Target operation chain ID. Use 8453 on production Base or 11155111 on sandbox Sepolia.

Example:

"8453"

signerAddress
string
required

Wallet that signs the prepared blockchain transaction.

Pattern: ^0x[a-fA-F0-9]{40}$
name
string
required
symbol
string
required
Pattern: ^[A-Z0-9]{2,11}$
agentWallet
string
required

Wallet that owns and mints the agent token.

Pattern: ^0x[a-fA-F0-9]{40}$
gasLimit

Optional explicit gas limit.

nonce
number

Optional explicit nonce when managing nonces manually.

privateRpcUrl
string

Optional private RPC URL override.

ownerEmail
string<email>

Optional owner attribution email.

email
string<email>

Alias for ownerEmail where supported.

premint

Human-readable premint amount.

decimals

Token decimals. Defaults to 18 when omitted.

Response

Prepared unsigned transaction payload.

transactions
object
txId
string
info
object