Historical Security Lookup
GET/api/v1.0/quote/{symbol}/historical-infoResolve 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
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/historical-info?date=1' \
-H 'Authorization: Bearer <AccessToken>' | jqResponse
| 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
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"items": [
{
"code": "example",
"src_code": "example",
"exchange": "example",
"name": "example",
"sc_name": "example",
"tc_name": "example"
}
]
}
}