Browse documentation
API referenceGET/v1/symbols/metadata1 credit / returned item

Get symbol metadata

GET /v1/symbols/metadata

Returns company names, logos, market cap, sectors, industry fields, macro indicators, scrip codes, and ISINs when available.

When to use it

Use this endpoint to enrich market data records before display or downstream agent processing.

Authentication and billing

  • Requires X-API-Key or api_key.
  • Credit cost: 1 credit / returned item. Bills 1 credit per returned metadata item. Requires Symbols product scope.
  • See pricing for plan allowances and full billing details.

Request

This endpoint does not require a request body.

FieldLocationRequiredNotes
symbolsqueryNoOptional comma-separated values such as RELIANCE,TCS or repeated query parameters. Maximum 20 symbols.
scrip_codesqueryNoOptional comma-separated values such as 500325,532540 or repeated query parameters. Maximum 20 scrip codes.
api_keyqueryNoOptional alternative to the X-API-Key header. Prefer the header for server-side applications.

Response

Returns data as an array of symbol metadata records.

Successful Responseapplication/json
{
  "data": [
    {
      "basic_industry": "Refineries & Marketing",
      "company_name": "Reliance Industries Limited",
      "industry": "Oil Gas & Consumable Fuels",
      "isin": "INE002A01018",
      "logo": "https://example.com/logos/reliance.png",
      "macro_economic_indicator": "Crude Oil",
      "market_cap": 2034500,
      "scrip_code": "500325",
      "sector": "Energy",
      "symbol": "RELIANCE"
    },
    {
      "basic_industry": "IT Consulting & Software",
      "company_name": "Tata Consultancy Services Limited",
      "industry": "Software Services",
      "isin": "INE467B01029",
      "logo": "https://example.com/logos/tcs.png",
      "macro_economic_indicator": "US Technology Spending",
      "market_cap": 1412800,
      "scrip_code": "532540",
      "sector": "Information Technology",
      "symbol": "TCS"
    }
  ]
}

Request pattern

bash
curl -G "https://developers.manasija.in/v1/symbols/metadata" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  --data-urlencode "symbols=RELIANCE,TCS"

JavaScript / TypeScript SDK

ts
const metadata = await client.getSymbolsMetadata({ symbols: ["RELIANCE", "TCS"] })

Python SDK

python
metadata = client.get_symbols_metadata(symbols=["RELIANCE", "TCS"])

Interactive reference

Use the Scalar API client for executable requests, schemas, and the full OpenAPI contract.