Historical Security Lookup

GET /api/v1.0/quote/{symbol}/historical-info

Resolve a security as of a historical date. Pass the current security symbol (e.g. HK.00700) and a trading day. Returns the security symbol, exchange code, names, and listing/delisting times for old news, filings, and recycled tickers. Empty items when the code did not exist on that date.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	Current symbol (path param), e.g. HK.00700 / US.AAPL
date	string	query	yes	As-of date yyyy-MM-dd (inclusive)

Example

curl -X GET 'https://webapi.futunn.com/api/v1.0/quote/US.AAPL/historical-info?date=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response

Field	Type	Description
data.items	object[]
data.items[].code	string	Resolved security symbol, e.g. HK.00700; empty if no matching security is found
data.items[].src_code	string	Exchange ticker on that date, e.g. 00700 / AAPL
data.items[].exchange	string	Trading exchange, e.g. SEHK / US / SSE / SZSE
data.items[].name	string	English name
data.items[].sc_name	string	Simplified Chinese name
data.items[].tc_name	string	Traditional Chinese name
data.items[].listing_time	integer	Listing/effective time, unix seconds
data.items[].delisting_flag	string	Whether the name was delisted as of that date
data.items[].delisting_time	integer	Delisting time, unix seconds

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "code": "example",
        "src_code": "example",
        "exchange": "example",
        "name": "example",
        "sc_name": "example",
        "tc_name": "example"
      }
    ]
  }
}