Skip to main content
Use the public Tokenized Stocks API to retrieve reference data for Coinbase-issued tokenized stocks on Base. The API is read-only and does not require an API key.
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.
Base URL
Browse the API reference for complete request and response schemas and an interactive request builder.

​
Endpoints

​
Wallet Positions and Profit and Loss

The API provides reference data, not wallet-specific data. No endpoint accepts a wallet address, and the API does not return a wallet’s positions, cost basis, trade history, or profit and loss. To show a holder’s current position in share-equivalent units, read the balance onchain with balanceOfUI, which applies the current multiplier (see Multipliers). A balance does not give you cost basis or profit and loss. To calculate those, you need trade history from every route you want to include. Your app’s own records cover only the trades made through your app.

​
List Tokenized Stocks

cURL
The response includes token contract addresses, symbols, names, descriptions, decimals, ISINs, and multipliers. Depending on the token, it can also include an icon URL, total supply, first-mint date, paused features, and NAV/reference value data. Presence in the response does not imply trading availability or eligibility. Results are paginated, so a single request may not return every record. When the response includes next_page_token, pass it as the page_token query parameter to fetch the next page, and repeat until next_page_token is omitted. Keep other request parameters unchanged between pages. Use page_size to set the page size. The default is 100 when omitted or set to 0. Values above 500 are capped at 500; negative values return HTTP 400. Tokens are ordered by contract address.
cURL

​
Interpreting Response Fields

JSON responses omit default-valued scalar fields, empty arrays, and unset timestamps. For example, a zero total_supply or empty paused_features array can be omitted. Do not assume every field is present, and do not treat missing NAV data as a usable price.
  • 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.
  • description is a human-readable description of the tokenized stock.
  • first_mint_date is the UTC block timestamp of the first positive ERC-20 mint, not the contract deployment time. It can be absent if the token has never been minted or its first mint has not yet been resolved. Later mints and burns do not change it.

​
Errors

JSON endpoints return an error object with code and message. The code is a service error code, not the HTTP status. For example:
Invalid Page Token
The icon and prospectus redirect endpoints return HTTP 302 with a Location header on success, not JSON. Their lookup and validation errors use plain-text bodies. See each endpoint’s reference for its specific responses. For integration guidance, price-feed details, and current token contract addresses, see List Tokenized Stocks.