Tokenization Suggest
Sends a free-text description of an asset to an AI provider and returns suggested values for the Create Token form: name, description, token name and symbol, total value, max supply and salable percentage. Nothing is stored. The AI providers are configured by the platform; list the ones you can pick with Get Tokenization Providers. Without provider, the first provider serving tokenization suggestions answers.
Required permission: token:ai-assist
Request
POST /v2/admin/tokens/tokenization-suggestions
Headers
| Name | Description |
|---|---|
Authorization | Required. Bearer <access_token> |
Content-Type | Required. application/json |
Body
| Field | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | Description of the asset to tokenize, in any language. |
provider | string | No | AI provider to ask: claude or openai. It must be configured and enabled for tokenization suggestions. |
Example
curl --request POST \
--url '{{baseUrl}}/v2/admin/tokens/tokenization-suggestions' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "12 month lease contract on a commercial real estate in Istanbul valued at 250,000 USDT",
"provider": "claude"
}'
Response
{
"suggested_name": "Istanbul Commercial Lease",
"suggested_description": "12-month lease on a commercial real estate asset in Istanbul.",
"suggested_token_name": "Istanbul Commercial Lease Token",
"suggested_token_symbol": "ICL",
"suggested_total_value": "250000",
"suggested_max_supply": 2500,
"suggested_salable_percentage": "80",
"prompt": "12 month lease contract on a commercial real estate in Istanbul valued at 250,000 USDT"
}
Response Fields
| Field | Type | Description |
|---|---|---|
suggested_name | string | Display name (name). |
suggested_description | string | Description (description). |
suggested_token_name | string | On-chain token name (token_name). |
suggested_token_symbol | string | On-chain symbol (token_symbol). |
suggested_total_value | string | Total value, a decimal string (total_value). |
suggested_max_supply | integer | Max supply (max_supply). |
suggested_salable_percentage | string | Salable percentage, "0" to "100" (salable_percentage). |
prompt | string | The prompt you sent. |
The values are suggestions: check them before creating the token. The response does not choose a currency token, category or setup.
Errors
| Status | Code | Description |
|---|---|---|
| 400 | 10015 | Validation failed (prompt missing) — see details |
| 400 | 79001 | provider is not a supported provider (AI provider setting domain 79) |
| 400 | 79005 | The named provider is disabled, not configured, or not enabled for tokenization suggestions (domain 79) |
| 400 | 79006 | No provider is enabled for tokenization suggestions (domain 79) |
| 500 | 10000 | The provider's answer could not be read |
See Errors for the error format and common codes.