Create Currency Token

Creates a new currency token under the specified node.

Request

POST /v2/admin/currency-tokens/nodes/{nodeID}

Parameters

Name	Type	In	Description
nodeID	string	path	Required. The ID of the node under which the currency token will be created

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Body (multipart/form-data)

Field	Type	Required	Description
name	string	Yes	Currency token display name
symbol	string	Yes	Currency token symbol (e.g., USDT, CSTM)
description	string	No	Description of the currency token
logo	file	No	Logo file (e.g., SVG/PNG)
fiat_currency	string	No	ISO 4217 fiat currency code (e.g., USD, EUR, TRY). Must be a valid ISO 4217 currency code

Example

curl --location '{{baseUrl}}/v2/admin/currency-tokens/nodes/665ae536a6392b75cfd40352' \
  --header 'Authorization: Bearer <token>' \
  --form 'name="Custom Stable Coin"' \
  --form 'symbol="CSTM"' \
  --form 'description="Example description"' \
  --form 'logo=@"/Users/burkaydurdu/Downloads/wallet.svg"' \
  --form 'fiat_currency="USD"'

Response

{
  "id": "690d004e8f95a5c7b2614658",
  "node_id": "665ae536a6392b75cfd40352",
  "type": 1,
  "status": 1,
  "name": "Custom Stable Coin",
  "symbol": "CSTM",
  "total_supply": 0,
  "description": "",
  "decimals": 6,
  "meta": {
    "logo": null
  },
  "contract": null,
  "is_active": false,
  "created_at": "2025-11-06T23:08:46.553086+03:00",
  "updated_at": "2025-11-06T23:08:46.553086+03:00"
}

Response Fields

Field	Type	Description
id	string	Unique ID of the currency token
node_id	string	Node ID the token belongs to
type	number	Token type identifier
status	number	Token status identifier
name	string	Currency token name
symbol	string	Currency token symbol
total_supply	number	Total supply (initially 0)
description	string	Description text
decimals	number	Decimal precision (e.g., 6)
meta.logo	string or null	Logo URL or null if not set
contract	object or null	Contract details if deployed
is_active	boolean	Whether the token is active
created_at	string	Creation timestamp
updated_at	string	Last update timestamp

Status Codes

Status Code	Description
201	Created - Currency token created successfully
400	Bad Request - Invalid input
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Node does not exist
415	Unsupported Media Type - Invalid file upload
500	Internal Server Error