Get Currency Token by ID

Reads one currency token by its ID. A token is addressed by its own ID everywhere; it is not nested under a node.

Required permission: currency-token:view

Request

GET /v2/admin/currency-tokens/{currency_token_id}

Parameters

Name	Type	In	Description
currency_token_id	string	path	Required. Currency token ID (24-character hex)

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/currency-tokens/6a859ae35a7db4268dfb40d2' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "id": "6a859ae35a7db4268dfb40d2",
  "node_id": "665ae536a6392b75cfd40352",
  "type": 1,
  "status": 3,
  "name": "Tether USD",
  "symbol": "USDT",
  "total_supply": "1000000",
  "description": "Stablecoin pegged to USD",
  "decimals": 6,
  "meta": {
    "logo": {
      "url": "https://s3.tokenizationtr.com/currencies/usdt.svg",
      "hash": "eb7dd8fc9d7d1e5f92b4cb9c1f3fba1537bf1ef007a77d4f7af918928d590de8"
    }
  },
  "fiat_currency": "USD",
  "contract": {
    "address": "0xdb2e8354c2a2a0f9c7c889ec27cdd424d49c8fd1",
    "tx_hash": "0xa4d1bbe5bc5309bce7c44c0c8259e4b8d59b80b7395e4acc047968340897c357"
  },
  "custody_asset_id": "",
  "custody_asset_registered_at": null,
  "network_id": "6a4bf0a21e781b11c22e9712",
  "wallet_id": "6a4bf1d31e781b11c22e9718",
  "created_by_id": "",
  "is_active": false,
  "is_self_issued": true,
  "created_at": "2026-09-14T08:12:44.310Z",
  "updated_at": "2026-09-14T08:21:05.114Z"
}

Response Fields

Field	Type	Description
id	string	Currency token ID
node_id	string	Node the token was created under
type	integer	1 stable token, 2 utility token, 3 a network's native coin
status	integer	1 Draft, 2 InProgress, 3 Active, 4 Error, 5 Passive
name	string	Display name
symbol	string	Symbol
total_supply	string	Total supply, decimal string
description	string	Description
decimals	integer	Decimal places of the token
meta.logo	object or null	Logo: url and hash. null when there is none
fiat_currency	string or null	ISO 4217 code the token is pegged to, or null
contract	object or null	address and deploy tx_hash once deployed; null before
custody_asset_id	string	The custody provider's ID for this currency. Empty until the currency is registered at custody
custody_asset_registered_at	string or null	When the custody registration was recorded
network_id	string	Network the token is on
wallet_id	string	Node custody wallet that signs the token's deploy, mint and send
created_by_id	string	Supervisor who created the token. Empty for tokens created with an API key
is_active	boolean	Always false in this response. Use status (3 = Active)
is_self_issued	boolean	true for the platform's own stablecoin, which can be minted and sent; false for a row that mirrors someone else's token
created_at	string	Creation time
updated_at	string	Last update time

Errors

Status	Code	Description
400	10015	Validation failed — see details
404	10001 (domain 15)	Currency token not found
500	10000	Unexpected server error, including a currency_token_id that is not a 24-character hex ID

See Errors for the error format and common codes.