API reference / Instruments
Instruments
Find tradable securities and exchange identifiers attached to companies.
Overview
An instrument is the exchange-traded security under a canonical company. Use this endpoint to move between ticker, exchange, segment, ISIN and company identity without guessing symbol mappings.
Coverage
| Records | Sources | Updated |
|---|---|---|
| NSE and BSE instruments | Official exchange masters | Refreshed from exchange listings |
Parameters
| Parameter | Type | Description |
|---|---|---|
ticker | string | Listed symbol |
exchange | string | NSE or BSE |
segment | string | Exchange segment |
type | string | Instrument type |
isin | string | 12-character ISIN |
company | string | Any accepted company reference |
limit | integer | 1–500; default 100 |
offset | integer | Result offset |
Getting started
Issue a key
Sign in, choose a plan and create an API key from your workspace dashboard.
Send the request
Call /v1/instruments with X-API-Key or an Authorization bearer token.
Read data and metadata
Use data for records and meta for timestamps, counts and request context.
Implementation notes
- →Ticker symbols are normalized to uppercase.
- →Use exchange-qualified references when the same symbol can exist on more than one venue.
Marked provides market data, not financial advice. Verify material decisions against the authoritative source.