Skip to main content

GET /v1/token-templates

List the pre-validated token contract templates that Qustody can instantiate. Each template targets a single QRC standard and exposes its constructor fields, supported operations, and feature flags (mintable, burnable, pausable, freezable, role-based).
AspectDetail
MethodGET
Path/v1/token-templates
AuthenticationBearer API key
Required permissionstokens:read
IdempotentYes — read-only
Approval policyNot applicable
Blockchain effectNone
Webhook eventsNone

Query parameters

NameTypeDescription
standardstringFilter by QRC standard (e.g. QRC-20).
limitintegerDefault 50, max 200.
offsetintegerPagination offset.

Example response

{
  "data": [
    {
      "templateId": "tpl_qrc20_v1",
      "standard": "QRC-20",
      "name": "QRC-20 fungible token (default)",
      "version": "1.0.0",
      "constructorFields": [
        { "name": "name", "type": "string", "required": true },
        { "name": "symbol", "type": "string", "required": true },
        { "name": "decimals", "type": "uint8", "required": true, "default": 18 },
        { "name": "initialSupply", "type": "uint256", "required": false, "default": "0" }
      ],
      "supportedOperations": ["deploy", "mint", "burn", "transfer", "pause", "unpause"],
      "features": {
        "mintable": true,
        "burnable": true,
        "pausable": true,
        "freezable": false,
        "roleBased": true
      },
      "implementationStatus": "proposed"
    }
  ],
  "pagination": { "total": 1, "limit": 50, "offset": 0 }
}

GET /v1/token-templates/{templateId}

Fetch a single template’s full descriptor, including ABI and bytecode hash.

Errors

CodeTypeMeaning
1701TOKEN_TEMPLATE_NOT_FOUNDUnknown template ID or standard mismatch.
1700TOKEN_STANDARD_NOT_SUPPORTEDFilter referenced an unsupported standard.