Skip to main content

Tokenization Suggest

Sends a free-form description of an asset to the tokenization assistant (backed by Claude) and returns suggested field values for creating a token. The response can be used to pre-fill the Create Token form.

Request

POST /v2/admin/tokens/nodes/{nodeID}/tokenization/suggest

Parameters

NameTypeInDescription
nodeIDstringpathRequired. The ID of the node the token will belong to
promptstringbodyRequired. Natural-language description of the asset to tokenize

Headers

NameDescription
AuthorizationRequired. Bearer token for authentication
Content-TypeRequired. Must be application/json

Example

curl --request POST \
--url '\{\{baseUrl\}\}/v2/admin/tokens/nodes/67d6c447f47ff3adafda700d/tokenization/suggest' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "12 month lease contract on a commercial real estate in Istanbul valued at 250,000 USDT"
}'

Response

{
"suggested_name": "Istanbul Commercial Lease #1",
"suggested_description": "12-month lease on a commercial real estate asset located in Istanbul...",
"suggested_token_name": "istLease",
"suggested_token_symbol": "ICL",
"suggested_total_value": 250000,
"suggested_max_supply": 2500,
"suggested_salable_percentage": 80,
"prompt": "..."
}

Response Fields

FieldTypeDescription
suggested_namestringSuggested display name for the token
suggested_descriptionstringSuggested long-form description
suggested_token_namestringSuggested short token name
suggested_token_symbolstringSuggested ticker-style token symbol
suggested_total_valuenumberSuggested total monetary value
suggested_max_supplyintegerSuggested max token supply
suggested_salable_percentagenumberSuggested salable percentage (0-100)
promptstringEcho of the submitted prompt (may be omitted)

Status Codes

Status CodeDescription
200Success
400Bad Request - nodeID missing or prompt invalid
401Unauthorized - Invalid or missing authentication token
500Internal Server Error - Upstream model failure