> ## Documentation Index
> Fetch the complete documentation index at: https://base-a060aa97-docs-kb-gaps-devrel-818-stablecoins-b20-assets.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tokenized Stocks API

> Read Coinbase-issued tokenized-stock records, protocol contract addresses, and normalized token supplies on Base.

Use the public Tokenized Stocks API to retrieve reference data for [Coinbase-issued tokenized stocks on Base](/build-on-base/integrate-defi/list-tokenized-stocks). The API is read-only and does not require an API key.

<Note>
  Coinbase tokenized stocks are available only to persons in eligible jurisdictions outside of the United States. This API provides read-only reference data only; it does not provide trading, execution, issuance, minting, redemption, or custody functionality. The availability of any token or related product may be subject to jurisdictional, eligibility, and compliance requirements. Integrators are responsible for applying applicable restrictions.
</Note>

The API returns token-level data only. It does not return a wallet's positions, cost basis, trade history, or profit and loss. To show a holder's position, read the token balance onchain and convert it with the current `multiplier` (see [List Tokenized Stocks](/build-on-base/integrate-defi/list-tokenized-stocks)). Cost basis and profit and loss across trading venues must come from your own records or an onchain indexer.

```text Base URL theme={null}
https://api.coinbase.com/v1/tokenized-stocks
```

[Browse the API reference](/sdks/tokenized-stocks/api-reference/list-tokenized-stocks) for complete request and response schemas and an interactive request builder.

## Endpoints

| Method | Path | Description |
| - | - | - |
| `GET` | `/` | List the tokenized-stock records currently exposed through the API. |
| `GET` | `/chains` | List the tokenized-stocks protocol contracts on each supported chain. |
| `GET` | `/total-supply/{contract_address}` | Get a token's total supply, normalized by its decimals. |

## List Tokenized Stocks

```bash cURL theme={null}
curl https://api.coinbase.com/v1/tokenized-stocks
```

The response includes each token's contract address, symbol, name, decimals, icon URL, total supply, ISIN, multiplier, paused features, and NAV/reference value data. Presence in the response does not imply trading availability or eligibility.

## Interpreting Response Fields

* **`total_supply`** is the token supply normalized by the token's decimals. It is a token-unit amount, not the number of underlying shares.
* **`multiplier`** is the current scaling factor between token units and underlying shares. It can change for corporate actions such as dividends or stock splits, so always apply the current value when converting token units to shares.
* **`nav_price`** is the most recently published Chainlink-based NAV/reference value for the token. It is not a live bid/ask or execution price.
* **`nav_price_updated_at`** is when `nav_price` was last updated onchain. Feeds update only on price deviation or heartbeat and hold their last value outside market hours, so check this timestamp and apply staleness bounds before relying on `nav_price`.

For integration guidance, price-feed details, and current token contract addresses, see [List Tokenized Stocks](/build-on-base/integrate-defi/list-tokenized-stocks).