Sign in

v1

latestOpenAPI 3.1.02026-07-13570316.1 KB
Tokens

Create Token

Create a new ERC20 token with the provided metadata and starting price. The token is immediately available for purchase using thirdweb Payments.

Authentication: This endpoint requires project authentication and wallet authentication. For backend usage, use x-secret-key header. For frontend usage, use x-client-id + Authorization: Bearer <jwt> headers.

post/v1/tokens

Request body

chainIdinteger required

The blockchain network identifier. Common values include: 1 (Ethereum), 8453 (Base), 137 (Polygon), 56 (BSC), 43114 (Avalanche), 42161 (Arbitrum), 10 (Optimism).

namestring required

Token name

symbolstring required

Token symbol

descriptionstring required

Token description

imageUrlstring uri required

Token image URL

fromstring

Wallet address or ENS that will deploy the token. If omitted, the project wallet will be used if available.

ownerstring

The token owner address, if different from from.

saltstring

A salt to deterministically generate the token address.

maxSupplynumber

The maximum token supply.

Example request

{
  "chainId": 42161,
  "name": "MyToken",
  "symbol": "MT",
  "description": "My very own token",
  "imageUrl": "https://picsum.photos/200",
  "from": "0xEfc38EF8C09535b25e364b6d1a7C406D3972f2A9",
  "maxSupply": 1000000000,
  "sale": {
    "type": "pool",
    "startingPrice": "100000",
    "amount": 1000000,
    "developerFeeBps": 10,
    "currency": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
  }
}

Response

The token is being deployed. Returns the predicted token address.

transactionIdstring required

The in-progress deployment transaction ID.

addressstring required

The address the token was deployed at