Skip to main content

Deploy Currency Token

Deploys the on-chain contract for an existing currency token. The currency token must already be created before deployment. This call is asynchronous — the handler enqueues a DeployCurrencyToken (type 1) blockchain transaction and returns HTTP 200 immediately. Poll Get Currency Token Transactions by ID to observe completion.

Request

POST /v2/admin/currency-tokens/{id}/deploy

Parameters

NameTypeInDescription
idstringpathRequired. Currency token ID

Headers

NameDescription
AuthorizationRequired. Bearer token for authentication

Example

curl --request POST \
--url '\{\{baseUrl\}\}/v2/admin/currency-tokens/68fe8c129367fd414b227c7a/deploy' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Response

A successful request returns an HTTP 200 status code with an empty response body. The 200 means the deploy was queued — not that the contract has been deployed. Poll Get Currency Token Transactions by ID for the most-recent DeployCurrencyToken transaction until its status reaches Done (3) or Error (4). Once Done, Get Currency Token By ID will reflect the populated contract address.

Status Codes

Status CodeDescription
200Success - Deployment dispatched
400Bad Request - Invalid ID or deploy preconditions failed
401Unauthorized - Invalid or missing authentication token
404Not Found - Currency token not found
500Internal Server Error