> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withconvexity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Issue and manage tokenized real-world assets: minting, burning, transfers, holders, and yield operations.

The **Tokenization** API lets you issue tokenized real-world assets and run their full
lifecycle: deploy a token on-chain, mint and burn supply, move it between registered
holders, and, for yield-bearing instruments, distribute coupons, let investors claim,
and redeem principal at maturity.

Write operations are asynchronous on-chain actions: they return an `operationRef` and a
`txHash` you can track via [Get Transaction](/api-reference/tokenization/get-transaction).

## The token object

| Attribute           | Type       | Description                                                           |
| ------------------- | ---------- | --------------------------------------------------------------------- |
| `id`                | `string`   | Unique token id.                                                      |
| `projectId`         | `string`   | Project that owns the token.                                          |
| `businessId`        | `string`   | Owning business.                                                      |
| `ticker`            | `string`   | Short token symbol (e.g. `BOND2`).                                    |
| `name`              | `string`   | Full token name.                                                      |
| `price`             | `string`   | Issue price per token in fiat major units.                            |
| `assetClass`        | `string`   | Asset class (e.g. `MONEY_MARKET`).                                    |
| `tokenType`         | `string`   | `ASSET` or `YIELD_BEARING`.                                           |
| `decimals`          | `integer`  | Token decimals (e.g. `18`).                                           |
| `totalSupply`       | `string`   | Total minted supply.                                                  |
| `circulatingSupply` | `string`   | Supply currently held by investors.                                   |
| `chain`             | `string`   | Primary chain (e.g. `BASE`).                                          |
| `status`            | `string`   | `PENDING` while deploying, then `ACTIVE`.                             |
| `chains`            | `object[]` | Per-chain deployment records (chain, `tokenAdmin`, contract address). |
| `createdAt`         | `string`   | ISO 8601 UTC timestamp.                                               |
| `updatedAt`         | `string`   | ISO 8601 UTC timestamp.                                               |

## The token transaction object

Returned by [Get Transaction](/api-reference/tokenization/get-transaction) and
[List Transactions](/api-reference/tokenization/list-transactions).

| Attribute     | Type             | Description                               |
| ------------- | ---------------- | ----------------------------------------- |
| `id`          | `string`         | Unique transaction id.                    |
| `tokenId`     | `string`         | Token the transaction belongs to.         |
| `chain`       | `string`         | Chain the transaction ran on.             |
| `projectId`   | `string`         | Owning project.                           |
| `type`        | `string`         | `MINT`, `BURN`, or `TRANSFER`.            |
| `status`      | `string`         | `PENDING` then `CONFIRMED` (or `FAILED`). |
| `fromAddress` | `string \| null` | Source address (null for mints).          |
| `toAddress`   | `string \| null` | Destination address (null for burns).     |
| `amount`      | `string`         | Amount moved, in token units.             |
| `txHash`      | `string`         | On-chain transaction hash.                |
| `blockNumber` | `integer`        | Block the transaction was included in.    |
| `gasUsed`     | `string`         | Gas units consumed.                       |
| `feeWei`      | `string`         | Fee paid, in wei.                         |
| `createdAt`   | `string`         | ISO 8601 UTC timestamp.                   |
| `updatedAt`   | `string`         | ISO 8601 UTC timestamp.                   |