---
title: "List stocks"
method: GET
path: "/api/v1/stocks"
tags: ["stocks"]
---

# List stocks

`GET /api/v1/stocks`

Returns a list of stocks with optional filtering and pagination.

## Query parameters

- `q` string
- `issuer` 'xStocks' | 'Ondo' | 'Robinhood' | 'Mock'
- `type` 'testnet' | 'mainnet'
- `chainId` integer
- `tokenAddress` string
- `tokenSymbol` string
- `sector` string
- `minMarketCap` number
- `maxMarketCap` number
- `minPrice` number
- `maxPrice` number
- `minVolume` integer
- `maxVolume` integer
- `minEmployees` integer
- `maxEmployees` integer
- `minTodaysChangePerc` number
- `maxTodaysChangePerc` number
- `minTodaysChange` number
- `maxTodaysChange` number
- `updatedFrom` string
- `updatedTo` string
- `limit` integer
- `cursor` string
- `offset` integer
- `sort` 'ticker' | 'marketCap' | 'price' | 'updatedAt' | 'volume' | 'todaysChangePerc' | 'todaysChange'
- `order` 'asc' | 'desc'

## Response `200`

Default Response

- object
  - `data` object[], required
    - `ticker` 'SPY' | 'QQQ' | 'AAPL' | 'NVDA' | 'MSFT' | 'AMZN' | 'META' | 'GOOGL' | 'TSLA' | 'MSTR' | 'HOOD' | 'CRCL' | 'COIN' | 'PLTR' | 'NFLX' | 'AMD' | 'STRC' | 'SPCX', required
    - `tokenizedAssets` object[], required
      - `chainId` integer, required
      - `address` string, nullable
      - `symbol` string, required
      - `name` string, required
      - `decimals` integer, required
      - `issuer` 'xStocks' | 'Ondo' | 'Robinhood' | 'Mock', required
      - `type` 'testnet' | 'mainnet', required
      - `logoURI` string, nullable
    - `metadata` object
      - `name` string, nullable
      - `currency_name` string, nullable
      - `address` object, nullable
        - `address1` string, required
        - `city` string, required
        - `state` string, required
        - `postal_code` string, required
      - `description` string, nullable
      - `sic_description` string, nullable
      - `ticker_root` string, nullable
      - `market_cap` number, nullable
      - `homepage_url` string, nullable
      - `total_employees` number, nullable
      - `list_date` union
        - string
        - string
      - `branding` object, nullable
        - `logo` string, nullable
        - `icon` string, nullable
      - `type` string, nullable
    - `liveMetrics` object
      - `price` number, required
      - `todaysChange` number, nullable
      - `todaysChangePerc` number, nullable
      - `prevClose` number, nullable
      - `open` number, nullable
      - `high` number, nullable
      - `low` number, nullable
      - `close` number, nullable
      - `volume` number, nullable
      - `updatedAt` union
        - string
        - string
    - `ratios` object
      - `earnings_per_share` number, nullable
      - `price_to_earnings` number, nullable
      - `price_to_book` number, nullable
      - `price_to_sales` number, nullable
      - `price_to_cash_flow` number, nullable
      - `price_to_free_cash_flow` number, nullable
      - `dividend_yield` number, nullable
      - `return_on_assets` number, nullable
      - `return_on_equity` number, nullable
      - `debt_to_equity` number, nullable
      - `current_assets` number, nullable
      - `quick_ratio` number, nullable
      - `cash` number, nullable
      - `ev_to_sales` number, nullable
      - `ev_to_ebitda` number, nullable
      - `free_cash_flow` number, nullable
      - `short_interest` number, nullable
      - `avg_daily_volume` number, nullable
      - `days_to_cover` number, nullable
    - `createdAt` string, required
    - `updatedAt` string, required
    - `id` string, required
  - `meta` object, required
    - `limit` integer, required
    - `offset` integer, required
    - `total` integer, required
    - `nextCursor` string

## Other responses

- `400` — Default Response
- `500` — Default Response

---

[API](https://skmtc.dev/edel/apis/edel-assets-api.md) · [All operations](https://skmtc.dev/edel/apis/edel-assets-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edel/edel-assets-api/revisions/e65f1b008fcb/schema)