Skip to main content

Get Currency Token Transactions by ID

Lists a currency token's on-chain transactions (deploy, mint, send), newest first. This is where the transaction_id returned by Deploy, Mint and Send is followed, and where the deploy started by Create Currency Token appears. An ID that matches no token answers an empty page.

Required permission: currency-token:view-transactions

Request​

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

Parameters​

NameTypeInDescription
currency_token_idstringpathRequired. Currency token ID (24-character hex)
pageintegerqueryRequired. Page number, starting at 1
per_pageintegerqueryRequired. Items per page, 1–100

Headers​

NameDescription
AuthorizationRequired. Bearer <access_token>

Example​

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

Response​

{
"data": [
{
"id": "6a8b5e13f9129816a6cc7a13",
"node_id": "665ae536a6392b75cfd40352",
"user_id": null,
"currency_token_id": "6a859ae35a7db4268dfb40d2",
"type": 3,
"status": 3,
"hash": "0x5c1e9a0f3b7d2c4e6a8b0d1f3e5a7c9b1d3f5e7a9c0b2d4f6e8a0c2e4f6a8b0d",
"error": null,
"data": {
"amount": "250.5",
"to_address": "0x3b4E4dd67EE4054514bA2101e981f4C4D44eFDDc"
},
"updated_at": "2026-09-14T09:02:31.870Z",
"created_at": "2026-09-14T09:01:58.402Z"
},
{
"id": "6a8b5c91f9129816a6cc79e2",
"node_id": "665ae536a6392b75cfd40352",
"user_id": null,
"currency_token_id": "6a859ae35a7db4268dfb40d2",
"type": 1,
"status": 3,
"hash": "0xa4d1bbe5bc5309bce7c44c0c8259e4b8d59b80b7395e4acc047968340897c357",
"error": null,
"data": null,
"updated_at": "2026-09-14T08:14:02.118Z",
"created_at": "2026-09-14T08:12:44.401Z"
}
],
"total": 2,
"page": 1,
"per_page": 20
}

Response Fields​

FieldTypeDescription
dataarrayTransactions on this page
data[].idstringTransaction ID
data[].node_idstringNode the transaction runs for (the token's node)
data[].user_idstring or nullUser the transaction was started for. null for deploy, mint and send
data[].currency_token_idstringCurrency token ID
data[].typeinteger1 DeployCurrencyToken, 2 MintCurrencyToken, 3 SendCurrencyToken
data[].statusinteger1 Started, 2 InProgress, 3 Done, 4 Error, 5 PendingReceipt (sent, waiting for the chain receipt). 1, 2 and 5 are not final
data[].hashstring or nullOn-chain transaction hash, once known
data[].errorstring or nullFailure reason when status is 4
data[].dataobject or nullRequest details: amount (decimal string) for a mint; amount and to_address for a send; null for a deploy
data[].updated_atstringLast status change
data[].created_atstringWhen the transaction was started
totalintegerNumber of transactions of the token
pageintegerCurrent page
per_pageintegerItems per page

Errors​

StatusCodeDescription
40010015Validation failed — see details
40010000The list could not be read, including a currency_token_id that is not a 24-character hex ID (this endpoint answers these with 400)

See Errors for the error format and common codes.