Create, list, get, and update tokens

A Token resource represents a QRC token tracked by Qustody. The resource is created in DRAFT state, transitions to DEPLOYED once an on-chain contract is associated, and continues to track every subsequent operation. See the full Token object.

`POST /v1/tokens`

Create a token configuration. This call does not deploy the contract on Quantum Chain — see Deploy token.

Aspect	Detail
Method	`POST`
Path	`/v1/tokens`
Authentication	Bearer API key
Required permissions	`tokens:create`
Idempotency	`Idempotency-Key` header recommended
Approval policy	Optional pre-deploy review (configurable)
Blockchain effect	None — config only
Webhook events	`token.created`

Request body

{
  "standard": "QRC-20",
  "templateId": "tpl_qrc20_v1",
  "name": "Example Institutional Token",
  "symbol": "EIT",
  "decimals": 18,
  "initialSupply": "0",
  "supplyPolicy": {
    "mintable": true,
    "burnable": true,
    "maxSupply": "1000000000000000000000000"
  },
  "admin": {
    "vaultAccountId": "vault_123",
    "approvalPolicyId": "policy_456"
  },
  "network": "quantum-chain-testnet"
}

Response (201)

{
  "id": "token_abc123",
  "standard": "QRC-20",
  "templateId": "tpl_qrc20_v1",
  "name": "Example Institutional Token",
  "symbol": "EIT",
  "decimals": 18,
  "status": "DRAFT",
  "network": "quantum-chain-testnet",
  "adminVaultAccountId": "vault_123",
  "approvalPolicyId": "policy_456",
  "createdAt": "2026-04-27T10:00:00Z"
}

`GET /v1/tokens`

List tokens. Supports filtering by status, standard, network, and adminVaultAccountId.

`GET /v1/tokens/{tokenId}`

Fetch a single token by its Qustody ID.

`PATCH /v1/tokens/{tokenId}`

Update mutable fields on a token in DRAFT state. Once the token has been deployed, only metadata fields (name, description, tags) remain mutable.

Status values

Value	Meaning
`DRAFT`	Configuration created but not yet deployed.
`DEPLOYING`	Deployment transaction submitted; awaiting confirmation.
`DEPLOYED`	Contract address confirmed on chain.
`PAUSED`	Token paused (if the standard supports pause).
`RETIRED`	Token deactivated within Qustody; on-chain state untouched.
`FAILED`	Deployment failed; see `failureReason`.

Errors

Code	Type	Meaning
1100	`VALIDATION`	Invalid request body.
1700	`TOKEN_STANDARD_NOT_SUPPORTED`	Unsupported `standard`.
1701	`TOKEN_TEMPLATE_NOT_FOUND`	Unknown `templateId`.
1300	`TX_NOT_FOUND`	Referenced approval policy or vault account missing.
1601	`IDEMPOTENCY_CONFLICT`	Same `Idempotency-Key` reused with different body.

List token templates Estimate token deployment

Overview

Health

Tenants

Vaults

Wallets

Transactions

Assets

Tokens

Webhooks

Administration

Create, list, get, and update tokens

`POST /v1/tokens`

Request body

Response (201)

`GET /v1/tokens`

`GET /v1/tokens/{tokenId}`

`PATCH /v1/tokens/{tokenId}`

Status values

Errors

​POST /v1/tokens

​Request body

​Response (201)

​GET /v1/tokens

​GET /v1/tokens/{tokenId}

​PATCH /v1/tokens/{tokenId}

​Status values

​Errors

​Related

`POST /v1/tokens`

Request body

Response (201)

`GET /v1/tokens`

`GET /v1/tokens/{tokenId}`

`PATCH /v1/tokens/{tokenId}`

Status values

Errors

Related