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

> ## Agent Instructions
> The Financial Datasets API is served at https://api.financialdatasets.ai. Authenticate with the `X-API-KEY` header; create keys at https://financialdatasets.ai. Agents can open and fund their own account without a dashboard: see https://docs.financialdatasets.ai/agents.md.
> Tool-using agents can call Financial Datasets without writing code through the hosted MCP server at https://mcp.financialdatasets.ai/.
> The OpenAPI spec at https://financialdatasets.ai/openapi.json is the source of truth for request and response schemas.
> The index of every docs page is at https://docs.financialdatasets.ai/llms.txt. Append .md to any docs URL to get that page as Markdown.

# Tokenized Stocks API (Coinbase and Base stock names)

> The stock tokens on Base, each with its ticker, its address, and the datasets we have for the stock. Free, with no API key.

### Overview

A tokenized stock is a token on a blockchain that stands for shares of a stock. `NVDAc` on Base stands for shares of NVIDIA. This endpoint lists the tokenized stocks we know. Each one comes with our ticker, its address, and the datasets we have for the stock.

The call is free. It needs no API key and no payment.

You do not need this endpoint to get data. Every stock endpoint accepts a Coinbase or a Base name in `ticker`. See [Coinbase and Base names](#coinbase-and-base-names).

### Coverage

| Issuer | Chain | Tokens | Updated |
| - | - | - | - |
| Coinbase | Base | 85+ | Every hour |

### Request

```python Python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests

response = requests.get(
    "https://api.financialdatasets.ai/tokenized-stocks",
    params={"ticker": "NVDAc"},
)
tokenized_stocks = response.json()["tokenized_stocks"]
```

```bash cURL theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl "https://api.financialdatasets.ai/tokenized-stocks?ticker=NVDAc"
```

| Parameter | Required | Value |
| - | - | - |
| `ticker` | No | A ticker, or any name from the [table below](#coinbase-and-base-names). Returns the tokens of that stock. |

Without `ticker`, the response has every token, sorted by ticker. There are no pages. A name with no token returns an empty list.

### The Response

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "tokenized_stocks": [
    {
      "ticker": "NVDA",
      "name": "NVIDIA Corporation",
      "issuer": "Coinbase",
      "chain": "base",
      "symbol": "NVDAc",
      "address": "0xb20000000000000000000078ee7ce2fe4908108c",
      "shares_per_token": 1.0005379395763694,
      "datasets": [
        "/prices",
        "/prices/snapshot",
        "/company/facts",
        "/financials",
        "/earnings",
        "/insider-trades",
        "/institutional-holdings"
      ]
    }
  ]
}
```

| Field | Value |
| - | - |
| `ticker` | Our ticker for the stock. Use it, or any other name of the stock, on every stock endpoint. |
| `name` | The company name. |
| `issuer` | The company that issues the token. |
| `chain` | The blockchain the token is on. |
| `symbol` | The token's symbol. |
| `address` | The token's contract address, in lower case. |
| `shares_per_token` | How many shares one token stands for. It is not always 1: multiply a share price by it to get the value of one token. |
| `datasets` | The endpoints that have data for this stock. Each one is a path you can call with the same name. |

### Coinbase and Base names

Every stock endpoint accepts these names in `ticker`. So do the `ticker` filters of the [stock screener](https://docs.financialdatasets.ai/api/financials/search-screener.md) and the [line-item search](https://docs.financialdatasets.ai/api/financials/search-line-items.md).

| You send | We read | Rule |
| - | - | - |
| `AAPL` | `AAPL` | Our ticker. |
| `AAPL-USD`, `AAPL-USDC` | `AAPL` | A Coinbase stock name, in any letter case. |
| `NVDAc` | `NVDA` | A Base token symbol, in its exact letter case. `NVDAC` is not the token. |
| `base:0xb200...108c`, `0xb200...108c` | `NVDA` | A Base token address, in any letter case, with or without `base:`. |

* The response is the same as for the plain ticker. Its `ticker` field is our ticker.
* A request with an [x402](https://docs.financialdatasets.ai/x402.md) payment accepts the same names.
* A token address we do not know returns `400` with the error `Unknown token address`. The request is not charged.
* The crypto endpoints do not change. `BTC-USD` on a crypto endpoint is Bitcoin.

### Related

> [card] [x402](https://docs.financialdatasets.ai/x402.md)
>
> Pay per request with a wallet, with no API key.

> [card] [Stock Prices](https://docs.financialdatasets.ai/api/prices/snapshot.md)
>
> The real-time price of a stock, by ticker or by token name.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.