---
title: "Stock metadata"
method: GET
path: "/stocks/{symbol}"
tags: ["Stock Data"]
---

# Stock metadata

`GET /stocks/{symbol}`

## Request

- Base URL: `https://stockmarketscan.com/api/v1`
- URL: `https://stockmarketscan.com/api/v1/stocks/{symbol}`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer
  - API key in header `X-RapidAPI-Key`

Name, exchange, industry, last price and daily percent change of one
symbol, taken from the newest screener snapshot that contains it
(field by field), otherwise from the latest daily candle. Fields come
only from the screeners available on the caller's plan. No API key
required (30 requests per minute per IP without one).

## Path parameters

- `symbol` string, required

## Headers

- `If-None-Match` string

## Response `200`

Stock metadata

- object
  - `data` StockInfo, required
    - `symbol` string, required
    - `symbol_name` string, nullable, required
    - `last_price` number, nullable, required
    - `percent_change` number, nullable, required: Daily change in percent: 1.27 means +1.27%.
    - `exchange` string, nullable, required
    - `industry` string, nullable, required
  - `meta` object, required: Response metadata. Endpoint-specific keys are documented per operation.
    - `as_of` string, date, nullable, required: Trading date of the underlying data. Null when there is no data.
    - `generated_at` string, date-time, required: When this response was produced (RFC 3339 UTC).
    - `pagination` Pagination: Present on list endpoints. Follow `next_cursor` until it is null.
      - `limit` integer, required: Page size that was applied.
      - `next_cursor` string, nullable, required: Cursor for the next page; null on the last page.
      - `total` integer: Rows across all pages. Only where it is cheap and exact.
    - `parameters` object: Parameters applied after defaults.

## Other responses

- `304`: Not modified since the ETag in `If-None-Match`. No body; not counted against your quota.
- `400`: Invalid parameter, cursor or body. Not counted against your quota.
- `401`: Missing or invalid credentials.
- `404`: Not found. Not counted against your quota.
- `429`: Rate limit or quota exceeded. `Retry-After` says when to retry.
- `500`: Unexpected server error. Quote `request_id` when reporting it.
- `503`: A dependency (database or key store) is unavailable.

---

[API](https://skmtc.dev/stockmarketscan/apis/stockmarketscan-api.md) · [All operations](https://skmtc.dev/stockmarketscan/apis/stockmarketscan-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stockmarketscan/apis/stockmarketscan-api/revisions/2cca1387a5fe?raw)