List Currency Tokens

Lists currency tokens, newest first. Every filter is optional and filters compose with AND. This is the only currency-token listing: the former GET /v2/admin/currency-tokens/active is now ?is_active=true (or ?statuses=3), and the former node-scoped listing is now ?node_id=.

Required permission: currency-token:view

Request

GET /v2/admin/currency-tokens?page={page}&per_page={per_page}

Parameters

Name	Type	In	Description
page	integer	query	Required. Page number, starting at 1
per_page	integer	query	Required. Items per page, 1–100
node_id	string	query	Only tokens created by this node (24-character hex)
network_id	string	query	Only tokens on this network (24-character hex)
is_active	boolean	query	true: only tokens in status 3 (Active). false: only tokens in any other status. Omit for all
statuses	integer	query	Only tokens in these statuses: 1 Draft, 2 InProgress, 3 Active, 4 Error, 5 Passive. Repeat the parameter for several (?statuses=1&statuses=2). An unknown status is refused
search	string	query	Case-insensitive substring match on the token's name or symbol

is_active and statuses compose: is_active=true&statuses=1 asks for something that cannot hold and answers an empty page.

Headers

Name	Description
Authorization	Required. Bearer <access_token>

Example

curl --request GET \
  --url '{{baseUrl}}/v2/admin/currency-tokens?page=1&per_page=20&is_active=true' \
  --header 'Authorization: Bearer <access_token>'

Response

{
  "data": [
    {
      "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"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	Currency tokens on this page
data[].id	string	Currency token ID
data[].node_id	string	Node the token was created under
data[].type	integer	1 stable token, 2 utility token, 3 a network's native coin
data[].status	integer	1 Draft, 2 InProgress, 3 Active, 4 Error, 5 Passive
data[].name	string	Display name
data[].symbol	string	Symbol
data[].total_supply	string	Total supply, decimal string
data[].description	string	Description
data[].decimals	integer	Decimal places of the token
data[].meta.logo	object or null	Logo: url and hash. null when there is none
data[].fiat_currency	string or null	ISO 4217 code the token is pegged to, or null
data[].contract	object or null	address and deploy tx_hash once deployed; null before
data[].custody_asset_id	string	The custody provider's ID for this currency. Empty until the currency is registered at custody
data[].custody_asset_registered_at	string or null	When the custody registration was recorded
data[].network_id	string	Network the token is on
data[].wallet_id	string	Node custody wallet that signs the token's deploy, mint and send
data[].created_by_id	string	Supervisor who created the token. Empty for tokens created with an API key
data[].is_active	boolean	Always false in this response. Use status (3 = Active)
data[].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
data[].created_at	string	Creation time
data[].updated_at	string	Last update time
total	integer	Number of tokens matching the filters
page	integer	Current page
per_page	integer	Items per page

Errors

Status	Code	Description
400	10015	Validation failed — see details. Includes a malformed node_id / network_id and an unknown statuses value
400	10000	The list could not be read (this endpoint answers store failures with 400)

See Errors for the error format and common codes.