Sandbox version
For experimental use only. Proceed with caution.
mptokens
List MPT issuances
get
/mpt/issuances
operationId: mpt-listIssuances

Returns the full catalog of multi-purpose token issuances indexed from the ledger, ordered by creation time (newest first). Each row describes the issuance itself — holders and transfers are exposed via the dedicated endpoints.

Unlock protected endpoints

Enter your Bearer token once to enable every protected route in this API reference.

HTTP bearer

Saved for this browser tab only. The credential is never sent until you test an endpoint.

Authorizations
NameLocationDetails
BearerAuthAuthorization header · bearerJWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.
Query Parameters
NameTypeDefaultDescription
cursor
string
limit
integer20
Responses
200
application/json
Successful response
FieldTypeDescription
items
object[]
Page of results.
items[].issuanceId
string
MPTokenIssuance ID (hex string).
items[].issuerAccount
string
XRPL address of the MPT issuer.
items[].assetScale
integer
Decimal places for display (e.g. 6 means 1,000,000 raw = 1 display unit).
items[].transferFee
integer
Transfer fee in basis points (0–10000).
items[].maxAmount
object
items[].requireAuth
boolean
Holders must be explicitly authorized by the issuer.
items[].canLock
boolean
Issuer is permitted to lock holder balances.
items[].canClawback
boolean
Issuer is permitted to clawback tokens from holders.
items[].assetClass
object
items[].assetSubclass
object
items[].metadataUri
object
items[].metadataJson
object
items[].metadataCdnUrl
object
items[].name
object
items[].ticker
object
items[].description
object
items[].iconUrl
object
items[].issuerName
object
items[].urls
object
items[].additionalInfo
object
items[].metadataFetchedAt
object
items[].createdLedger
integer
Ledger sequence where the issuance was created.
items[].createdAt
integer
Record creation timestamp, Unix-seconds.
items[].destroyedLedger
object
items[].currentSupply
string
Current outstanding supply (maintained incrementally), decimal string.
items[].holderCount
integer
Current holder count (maintained incrementally).
items[].lastPriceXrp
object
items[].priceChange24hPct
object
items[].volume24hXrp
object
items[].volume7dXrp
object
items[].trades24h
object
items[].lastTradeAt
object
nextCursor
object
Cursor to fetch the next page, or null if this is the last page.
Example
Json
{
  "items": [
    {
      "issuanceId": "string",
      "issuerAccount": "string",
      "assetScale": 0,
      "transferFee": 0,
      "maxAmount": "string",
      "requireAuth": false,
      "canLock": false,
      "canClawback": false,
      "assetClass": "string",
      "assetSubclass": "string",
      "metadataUri": "string",
      "metadataJson": "string",
      "metadataCdnUrl": "string",
      "name": "string",
      "ticker": "string",
      "description": "string",
      "iconUrl": "string",
      "issuerName": "string",
      "urls": "string",
      "additionalInfo": "string",
      "metadataFetchedAt": "string",
      "createdLedger": 0,
      "createdAt": 1745798400,
      "destroyedLedger": 0,
      "currentSupply": "string",
      "holderCount": 0,
      "lastPriceXrp": "string",
      "priceChange24hPct": "string",
      "volume24hXrp": "string",
      "volume7dXrp": "string",
      "trades24h": 0,
      "lastTradeAt": "string"
    }
  ],
  "nextCursor": "string"
}
400
application/json
Invalid input data
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
401
application/json
Authorization not provided
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
403
application/json
Insufficient access
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
404
application/json
Not found
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
500
application/json
Internal server error
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}