Create new token transaction

Creates a new token on-chain. This endpoint prepares and optionally executes the blockchain transaction to deploy a new token contract with specified parameters.

Supports:

• Token metadata (name, symbol, description)
• Media assets (logo, banner, video)
• Multiple chains (Base, Base Sepolia)
• Optional hashtags/tags
• Automatic token URI generation and IPFS storage

Returns transaction data for client-side execution or confirmation of server-side execution.

USD Rewards Attribution:

• Builder attribution: Set custom builder fees (in basis points) to earn USD rewards on token creation
• Token referral: Enable affiliate programs by specifying referral addresses for token trades
• USD rewards are processed in real-time on-chain with no third parties involved
• Token referrals have no additional cost to users - enabling affiliate programs onchain

POST /create-token-transaction

Create new token transaction

cURL

curl --request POST \
  --url https://yppncslmsswqydhhgygz.supabase.co/functions/v1/create-token-transaction \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "My Cool Token",
  "symbol": "MCT",
  "description": "A revolutionary new token",
  "image": "https://example.com/logo.png or data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "chainSlug": "base-sepolia",
  "banner": "https://example.com/banner.png or data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "video": "https://example.com/promo.mp4 or data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAACKBtZGF0AAAC",
  "links": {
    "website": "https://example.com",
    "twitter": "https://twitter.com/example",
    "youtube": "https://youtube.com/@example",
    "discord": "https://discord.gg/example",
    "telegram": "https://t.me/example"
  },
  "destinationChains": [
    "base-sepolia",
    "bnb-testnet",
    "solana-devnet"
  ],
  "poolType": "meme",
  "userAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "token_referral": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "tags": [
    "defi",
    "meme"
  ],
  "type": "coin"
}
'

200

{
  "success": true,
  "executed": true,
  "transactionHash": "<string>",
  "chainId": 84532,
  "transaction": {
    "to": "<string>",
    "data": "<string>",
    "value": "<string>",
    "gasLimit": "<string>"
  },
  "metadata": {
    "tokenUri": "<string>",
    "tokenId": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "slug": "<string>",
    "description": "<string>",
    "hubUrl": "https://onthrust.com/hub/my-cool-token",
    "addresses": {
      "evm": "<string>",
      "solana": "<string>"
    },
    "token_layer_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  }
}

Authorizations

Authorization · string · header · required

JWT token or API key

Body

application/json

name · string · required

Token name

Minimum string length: 1

Example:

"My Cool Token"

symbol · string · required

Token symbol (ticker)

Required string length: 1 - 10

Example:

"MCT"

description · string · required

Token description

Minimum string length: 1

Example:

"A revolutionary new token"

image · string · required

Token logo image - can be either a URL or base64-encoded image data (data:image/...)

Minimum string length: 1

Example:

"https://example.com/logo.png or data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="

chainSlug · enum<string> · required

Blockchain identifier. Supported chains: solana-devnet, base, base-sepolia, avalanche, bnb, bnb-testnet, unichain, unichain-testnet, abstract, polygon, zkSync, zkSync-testnet

Available options: solana-devnet, base, base-sepolia, avalanche, bnb, bnb-testnet, unichain, unichain-testnet, abstract, polygon, zkSync, zkSync-testnet

Example:

"base-sepolia"

banner · string

Banner image - can be either a URL or base64-encoded image data (data:image/...)

Minimum string length: 1

Example:

"https://example.com/banner.png or data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="

video · string

Promotional video - can be either a URL or base64-encoded video data (data:video/...)

Minimum string length: 1

Example:

"https://example.com/promo.mp4 or data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAACKBtZGF0AAAC"

links · object

Optional social media and website links

Show child attributes

destinationChains · enum<string>[]

Optional array of destination chain slugs for cross-chain token deployment and migration endpoints. Defaults to [base-sepolia, bnb-testnet, solana-devnet]. The initial chain will be automatically excluded from migration endpoints.

Blockchain identifier. Supported chains: solana-devnet, base, base-sepolia, avalanche, bnb, bnb-testnet, unichain, unichain-testnet, abstract, polygon, zkSync, zkSync-testnet

Available options: solana-devnet, base, base-sepolia, avalanche, bnb, bnb-testnet, unichain, unichain-testnet, abstract, polygon, zkSync, zkSync-testnet

Example:

[
  "base-sepolia",
  "bnb-testnet",
  "solana-devnet"
]

poolType · enum<string>

Type of token pool. Defaults to "meme". Maps to: meme=7, startup-preseed=8

Available options: meme, startup-preseed

Example:

"meme"

userAddress · string

User wallet address (optional - if not provided, will use user's Privy wallet from user_wallets table)

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

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

builder · object

Builder attribution information (optional). Includes address and fee in bps.

Show child attributes

token_referral · string

Token referral address for attribution (optional - defaults to zero address). Used to attribute referral fees to a specific address.

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

Example:

"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"

tags · string[]

Optional hashtags/tags for the token

Example:

["defi", "meme"]

type · enum<string> · default: coin

Transaction type (currently only "coin" is supported - placeholder for future integration)

Available options: coin

Example:

"coin"

Response

200

application/json

Successful response

success · enum<boolean> · required

Available options: true

executed · boolean

transactionHash · string

chainId · integer

Numeric chain ID for the transaction

Example:

84532

transaction · object

Show child attributes

metadata · object

Show child attributes