get_securities

Resolve exact security identifiers (ISIN, CUSIP, SEDOL, listing codes) to issuer records.

Overview

The get_securities tool resolves one or more exact security identifiers to issuer/company records from the Bigdata.com Knowledge Graph. This tool is designed for precise identifier resolution when you already have a CUSIP, ISIN, SEDOL, or exchange listing code.

The tool automatically infers identifier type based on format:

• Length 12 → ISIN
• Length 9 → CUSIP
• Length 7 → SEDOL
• Contains ”:” → LISTING (e.g., XNAS:AAPL)

Use this tool when you have exact identifiers and need to resolve them to security records. For fuzzy name or theme searches, use find_securities instead.

Install the Bigdata plugin to guide your Agent in creating professional financial research reports using the Bigdata MCP tools.

Parameters

Parameter	Type	Required	Description
market_identifiers	string[] (1-50 items)	Yes	Array of exact identifiers. Type is auto-inferred: length 12 = ISIN, length 9 = CUSIP, length 7 = SEDOL, contains ”:” = LISTING (e.g., XNAS:AAPL). Mixed identifier types in one request are supported.

Response

Returns a JSON object with:

• results: Map of each requested identifier → resolved object (or null if unknown/malformed)
  • Each resolved entry includes security_type: COMPANY, ETF, MUTUAL_FUND, FUND or BOND. MUTUAL_FUND is an open- or closed-ended mutual fund, FUND is any other open- or closed-ended fund. An identifier that resolves to a bond is a BOND whatever kind of issuer sits behind it, and nests that issuer under details.company
  • The same five values are what find_securities returns, so a security carries one name across both tools
  • Includes RavenPack entity ID (id) and security metadata
• metadata: request_id and timestamp

Error Handling: Malformed identifiers are skipped with an explanatory message. Well-formed identifiers are still resolved even if others in the batch are malformed.

Usage Monitoring

The tool get_securities does not consume any quota.

Key Differences from find_securities

Feature	get_securities	find_securities
Purpose	Resolve multiple securities to their Knowledge Graph IDs	Identify one Knowledge Graph ID based on a Fuzzy/name/theme search
Input	Exact ISIN, CUSIP, SEDOL, or listing code	Name, ticker, theme, or partial identifier
Use When	You already have precise identifiers	You need to search for securities
Batch Support	1-50 identifiers per request	Retrieve the top 5 matches for a given focused search token
Auto-inference	Identifier type inferred from format	Searches across all identifier types