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

# tRPC Tokenized Issuances API

> Tokenized issuances of an equity canonical with share-equivalent framing.

The `tokenizedIssuances.*` namespace lists every onchain tokenization of one
equity canonical (e.g. for canonical `TSLA`: Ondo's `TSLAon` on Ethereum, BNB
Chain and Solana, plus Robinhood Chain's `TSLA` token) together with
share-conversion framing from the multi-issuer share-conversion foundation.

* Base endpoint: `POST /v1/trpc`
* Namespace: `tokenizedIssuances.*`
* Auth: public (rate-limited, Tier 2)
* Primary model: identity ≠ acquisition. A listed issuance is a statement
  that the tokenization exists and rolls up to the canonical — not that it
  is buyable through Glider. `isGliderSupported` carries the acquisition
  posture.
* Share math: `sharesPerToken` and `fairTokenPriceUsd` are resolved by the
  server-side share-conversion facade at ONE effective instant (paired
  price+factor sampling). When a factor is unknown or missing the derived
  fields are `null` — clients must render identity only and must never
  assume a 1:1 token-to-share ratio.

## Procedures

* `tokenizedIssuances.listForCanonical`
  * Purpose: the symbol page's "Tokenized versions" section — every
    issuance of one canonical across issuers and chains
  * Input:
    * required `assetCanonicalId`: `core.asset_canonical` uuid (from
      `assetTaxonomy.resolveSymbol`)
  * Response: array of issuances, one per token asset:
    * `assetId`: `public.assets.id` of the issuance token
    * `chainNamespace` / `chainReference`: CAIP chain identity (e.g.
      `eip155` / `4663` for Robinhood Chain)
    * `assetNamespace` / `assetReference`: CAIP asset identity (token
      address or Solana mint)
    * `tokenSymbol`, `decimals`
    * `providerSlug`: issuer registry slug (`ondo`, `robinhood`, …) or
      `null` on legacy links
    * `issuerSlug` / `issuerName`: issuer entity when modeled, else `null`
    * `productDisplayName` / `productImageUrl`: best linked product
      branding, else `null`
    * `isGliderSupported`: acquisition posture (see above)
    * `sharesPerToken`: decimal string, shares represented by one token at
      the effective instant (e.g. `4.0` after CRWD's 4:1 split under
      ERC-8056), or `null`
    * `mechanism`: factor mechanism provenance (`shares_multiplier`,
      `erc8056_scaled_ui`, …), or `null`
    * `factorEffectiveFrom`: when the current factor took effect, or `null`
    * `fairTokenPriceUsd`: canonical per-share price × factor at the same
      instant, or `null`; per-token quotes are never re-multiplied
    * `sharePriceUsd` / `priceAsOf`: the per-share leg the fair price was
      derived from, or `null`
    * `provisional`: `true` while a share-conversion reconciliation flag is
      active for the issuance — display values as provisional (PRD R4)