Get Currency Token Transactions by ID

Lists transactions for the specified currency token with pagination.

Request

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

Parameters

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

Query Parameters

Name	Type	Required	Description
page	number	No	Page number (default: 1)
per_page	number	No	Items per page (default: 20)

Headers

Name	Description
Authorization	Required. Bearer token for authentication

Example

curl --location 'http://localhost:3453/v2/admin/currency-tokens/68fb4de0d622a0564999aeb7/transactions?page=1&per_page=20' \
  --header 'Authorization: Bearer <token>'

Response

{
  "data": [
    {
      "id": "68fb4de1d622a0564999aeb8",
      "node_id": "665ae536a6392b75cfd40352",
      "user_id": "665b372f3a72d7d0791596ba",
      "currency_token_id": "68fb4de0d622a0564999aeb7",
      "external_id": "wallet-req-9a82",
      "type": 1,
      "status": 2,
      "hash": null,
      "error": null,
      "data": null,
      "is_api": true,
      "updated_at": "2025-10-24T10:03:35.75Z",
      "created_at": "2025-10-24T09:58:57.06Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20
}

Response Fields

Field	Type	Description
data	array	List of transactions
data[].id	string	Transaction ID
data[].node_id	string	Node ID
data[].user_id	string or null	User ID (if applicable). Currency token transactions track an optional originating user — nil for system-driven flows like initial deploys.
data[].currency_token_id	string	Currency token ID
data[].external_id	string	Wallet API request ID — correlates with the wallet service's own logs.
data[].type	number	Transaction type (see Enums)
data[].status	number	Transaction status (see Enums)
data[].hash	string or null	Transaction hash (if available)
data[].error	string or null	Error message if failed
data[].data	object or null	Additional data payload (type-specific)
data[].is_api	boolean	true when the request originated from the integration API (vs. internal tooling).
data[].updated_at	string	Last update timestamp
data[].created_at	string	Creation timestamp
total	number	Total number of transactions
page	number	Current page
per_page	number	Items per page

Enums

• Type (data[].type):

  • 1: DeployCurrencyToken
  • 2: MintCurrencyToken
  • 3: SendCurrencyToken

• Status (data[].status):

  • 1: Started — request queued, wallet pipeline hasn't picked it up yet.
  • 2: InProgress — wallet is preparing / signing.
  • 3: Done — confirmed on-chain.
  • 4: Error — failed; see error.
  • 5: PendingReceipt — broadcast on-chain (hash populated); receipt-confirmation cron is still waiting for inclusion. Treat as not-yet-final.

Notes:

• Non-completed statuses are: Started, InProgress, PendingReceipt.
• data is a key-value map for type-specific context.

Status Codes

Status Code	Description
200	Success - Transactions retrieved successfully
400	Bad Request - Invalid ID or query params
401	Unauthorized - Invalid or missing authentication token
404	Not Found - Currency token does not exist
500	Internal Server Error