---
title: "Get instrument details (fundamentals alias)"
method: GET
path: "/v1/fnd/symbols/{asset_class}/{symbol}"
tags: ["Symbols"]
---

# Get instrument details (fundamentals alias)

`GET /v1/fnd/symbols/{asset_class}/{symbol}`

## Request

- Base URL: `https://api.sifting.io`
- URL: `https://api.sifting.io/v1/fnd/symbols/{asset_class}/{symbol}`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/sifting/apis/siftingio-market-data-api/docs/v1/fnd/symbols/:asset_class/:symbol/get.ts> (a function with typed inputs; its response is checked against the schema)

Look up a stock, crypto, forex or commodity catalog entry using its
asset class and symbol, for example `/v1/fnd/symbols/stocks/AAPL`.
The asset class is normalized to lowercase and the symbol to uppercase.
Inactive and delisted entries can also be returned.
For DEX instruments, use the detail path with a separate chain segment.
Normal API-key authentication and usage limits apply; no market
entitlement is required. Gzip is supported but not required.

## Path parameters

- `asset_class` 'stocks' | 'crypto' | 'forex' | 'commodities', required
- `symbol` string, required

## Response `200`

Catalog entry, including inactive or delisted entries when present.

- SymbolCatalogDetailResponse
  - `data` CatalogInstrument, required: Instrument reference metadata. Optional string fields are omitted when unavailable. Catalog status does not establish the availability or freshness of live prices or historical bars.
    - `slug` string, required: Canonical identifier with literal slash separators: asset_class/symbol, or dex/chain/symbol for DEX. Encode segments separately when building a detail URL.
    - `asset_class` 'stocks' | 'crypto' | 'dex' | 'forex' | 'commodities', required
    - `venue` string, required: Venue tag stored in the catalog.
    - `market_id` string: Market identifier, when mapped.
    - `symbol` string, required: Canonical instrument symbol.
    - `name` string
    - `base_asset` string
    - `quote_asset` string
    - `currency` string
    - `status` 'active' | 'inactive' | 'delisted', required
    - `details` object, required: Asset-specific metadata; an empty object when unavailable.
  - `meta` object, required
    - `as_of` string, date-time, required: Response generation time, not the underlying market data timestamp.

## Other responses

- `401`: Missing or invalid API key.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: The catalog could not be read.
- `503`: Upstream or snapshot temporarily unavailable.

---

[API](https://skmtc.dev/sifting/apis/siftingio-market-data-api.md) - [All operations](https://skmtc.dev/sifting/apis/siftingio-market-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sifting/apis/siftingio-market-data-api/revisions/c570068c2359?raw)