Get Currency Token by ID

Retrieves detailed information about a currency token with the specified ID.

Request

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

Parameters

Name	Type	In	Description
currencyTokenID	string	path	Required. The ID of the currency token to retrieve

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --location 'http://localhost:3453/v2/admin/currency-tokens/68fb4de0d622a0564999aeb7' \
  --header 'Authorization: Bearer <token>'

Response

{
  "id": "68fb4de0d622a0564999aeb7",
  "node_id": "665ae536a6392b75cfd40352",
  "type": 1,
  "status": 3,
  "name": "DigitalOceanCoin",
  "symbol": "DGCN",
  "total_supply": 0,
  "description": "Digitalocean coin",
  "decimals": 6,
  "meta": {
    "logo": {
      "url": "https://fra1.digitaloceanspaces.com/apex/dev/currency-token/68fb4de0d622a0564999aeb7/logo/c92b945b-c846-442b-9019-888f3b4d39df.png",
      "hash": "eb7dd8fc9d7d1e5f92b4cb9c1f3fba1537bf1ef007a77d4f7af918928d590de8"
    }
  },
  "contract": {
    "address": "0xd54549a98607c71cf67a4e0e83d84094971df3b7",
    "tx_hash": "0xa4d1bbe5bc5309bce7c44c0c8259e4b8d59b80b7395e4acc047968340897c357"
  },
  "is_active": false,
  "created_at": "2025-10-24T09:58:56.792Z",
  "updated_at": "2025-10-26T21:50:10.499Z"
}

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
description	string	Description text
decimals	number	Decimal precision
meta.logo.url	string	Public URL of the token logo
meta.logo.hash	string	Content hash of the logo file
contract.address	string	Contract address (if deployed)
contract.tx_hash	string	Deployment transaction hash (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
200	Success - Currency token retrieved successfully
400	Bad Request - Invalid ID
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Currency token does not exist
500	Internal Server Error