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.
Overview
Theget_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)
find_securities instead.
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
nullif unknown/malformed)- Each resolved entry includes
security_type:COMPANY,ETF, orBOND - Includes RavenPack entity ID (
id) and security metadata
- Each resolved entry includes
- metadata:
request_idandtimestamp
Usage Monitoring
The toolget_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 |