Resolve ambiguous ticker query to canonical symbol
Changed onDisambiguates ticker queries against a Blob-cached static map of 30+ primary-source publishers (Wikidata + OpenFIGI + per-exchange CSVs) rebuilt biweekly by sugra-ingest. Falls back to upstream /search with name cross-validation for queries the static map does not cover. Use ?strict=true to skip the upstream fallback (deterministic mode for AI agents).
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v2/quotes/resolve
- Auth: API key in header x-api-key
Query parameters
Ticker symbol (e.g. BABA, 9988, 7203, 9988.HK) or company name (Alibaba).
When true, return 404 if the static map has no entry (skip upstream /search fallback).
Response
Canonical Sugra Finance symbol plus exchange / company metadata.
Example response
{
"data": {
"symbol": "9988.HK",
"exchange": "HKG",
"name": "Alibaba Group Holding Limited",
"source": "static_map",
"primary_listing": "9988.HK",
"alternatives": [
"9988.HK"
],
"share_class_siblings": [
"BRK-B"
],
"company_id": "Q1359568",
"figi": "BBG006G2JVL2",
"delisting_signals": [
"wikidata_p582"
],
"delisting_end_date": "2020-11-12",
"relisted_at": "2021-11-09",
"listing_date": "2008-10-06",
"series": "EQ",
"group": "A"
},
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"data_age_days": 8.532,
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
],
"stale_since": "2026-09-08T12:00:00Z",
"period": "2026-Q1",
"notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
}
}Changes
- breaking
added
subschema #2to the response bodyoneOflist for the response status - breaking
the response's body type changed from
objectto no type for status - breaking
removed the required property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - info
added the non-success response with the status
- info
added the non-success response with the status
- info
added the non-success response with the status
- breaking
- info
added the optional property
/to the response with the status
- info