> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Tip>
  Install the [Financial Research Analyst](/skills-reference/mcp-helpers/financial-research-analyst) skill to guide your Agent in creating professional financial research reports using the Bigdata MCP tools.
</Tip>

## 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`, or `BOND`
  * 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                               |