v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Finance

Resolve ambiguous ticker query to canonical symbol

Disambiguates 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).

get/api/v2/quotes/resolve

Query parameters

qstring required

Ticker symbol (e.g. BABA, 9988, 7203, 9988.HK) or company name (Alibaba).

Ticker symbol (e.g. BABA, 9988, 7203, 9988.HK) or company name (Alibaba).

strictboolean

When true, return 404 if the static map has no entry (skip upstream /search fallback).

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",
    "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"
    ]
  }
}