/api/v1/financials/lei-to-tickerLEI to Ticker
Returns the LEI's name together with the SEC entities (ticker mappings) associated with that LEI. Call it to resolve a Legal Entity Identifier to its publicly traded ticker(s). Returns 404 when no SEC ticker mapping exists for the LEI, 400 for an invalid LEI parameter, and 500 on internal failure.
When to use it
- Resolve an LEI to its SEC ticker
- Look up the entity name behind an LEI
- Find publicly traded entities for a legal entity identifier
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Rate limit
Every call counts against your workspace’s daily quota for financial-metrics. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 10 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| lei | string | Yes | minimum length 20; maximum length 20; input normalized server-side (.toUpperCase()); must match pattern /^[A-Z0-9]{20}$/ (Invalid LEI format) |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/financials/lei-to-ticker?lei=your_lei"
Response envelope
Successful responses wrap the payload in a success flag.
{
"success": true,
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}Response shape
Payload: data.secEntities — SEC Entities
Common row fields
| Field | Description |
|---|---|
| ticker | Record identifier |
| name | Main display field |
| cik | — |
Empty results: No record found (HTTP 404) (HTTP 404: no SEC ticker mapping for this LEI - the entity may be privately held, not publicly traded, or not yet resolved; NOT evidence the LEI is invalid)
Bridge tool: LEI -> ticker(s); carries NO financial data itself. data.secEntities rows ({ticker, cik, name}) are the complete mapping (no pagination / cap; multiple rows are possible for multiple listings). Each row's ticker is directly usable with Financial Metrics and Sponsor Profile.
Catalog version mcp-2026-10-28 · generated from the live MCP catalog