Skip to main content
GET
/
v1
/
market
/
stock-info
Stock Information
curl --request GET \
  --url https://api.tickdb.ai/v1/market/stock-info \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "700.HK",
      "name_cn": "腾讯控股",
      "name_en": "TENCENT",
      "name_hk": "騰訊控股",
      "exchange": "SEHK",
      "currency": "HKD",
      "lot_size": 100,
      "total_shares": 9106356125,
      "circulating_shares": 9106356125,
      "hk_shares": 9106356125,
      "eps": "23.013927604754377",
      "eps_ttm": "26.2097750997138276",
      "bps": "140.9780051897266427",
      "dividend_yield": "4.5408485490127919",
      "stock_derivatives": [
        2
      ]
    },
    {
      "symbol": "AAPL.US",
      "name_cn": "苹果",
      "name_en": "Apple Inc.",
      "name_hk": "蘋果",
      "exchange": "NASD",
      "currency": "USD",
      "lot_size": 1,
      "total_shares": 14681140000,
      "circulating_shares": 14656175336,
      "eps": "7.6295165089359546",
      "eps_ttm": "8.0223334155249524",
      "bps": "6.0070267022860623",
      "dividend_yield": "1.04",
      "stock_derivatives": [
        1
      ]
    },
    {
      "symbol": "000001.SZ",
      "name_cn": "平安银行",
      "name_en": "PAB",
      "name_hk": "平安銀行",
      "exchange": "SZSE",
      "currency": "CNY",
      "lot_size": 100,
      "total_shares": 19405918198,
      "circulating_shares": 19405762053,
      "eps": "2.146707",
      "eps_ttm": "2.2218995030311835",
      "bps": "23.0845557231179667",
      "dividend_yield": "0.5980134452589843"
    }
  ]
}

​
Notes

  • Returned information may vary depending on data source

​
Supported Markets

US Stocks, HK Stocks, A-Shares Examples:
  • US Stocks: AAPL.US, TSLA.US, MSFT.US
  • HK Stocks: 700.HK, 9988.HK, 3690.HK
  • A-Shares: 000001.SH, 000001.SZ

​
Request Parameters

ParameterRequiredDescription
symbolsYesStock symbol codes, comma-separated, max 50
typeNoSymbol type, optional. Not required when the symbol is unambiguous; if the API returns an AMBIGUOUS_SYMBOL error, pass the value as indicated. Values: stock, indices, crypto, forex

​
Response Fields

FieldDescription
symbolTrading Symbol
name_cnChinese simplified name
name_enEnglish name
name_hkChinese traditional name
exchangeExchange where the symbol is traded
currencyTrading currency (CNY/USD/HKD)
lot_sizeShares per lot
total_sharesTotal shares outstanding
circulating_sharesCirculating shares
hk_sharesHK shares (HK stocks only)
epsEarnings per share
eps_ttmEarnings per share (TTM)
bpsBook value per share
dividend_yieldDividend yield (if calculated annually, annual calculation type provided)
stock_derivativesOptions: 1 - Options, 2 - Warrants

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
symbols
string
default:700.HK,AAPL.US,000001.SZ
required

Comma-separated stock symbols (max 50)

Example:

"700.HK,AAPL.US,000001.SZ"

​
type
enum<string>

Symbol type, optional. Not required when the symbol is unambiguous; if the API returns an AMBIGUOUS_SYMBOL error, pass the value as indicated

Available options:
stock,
indices,
crypto,
forex
Example:

"stock"

Response

200 - application/json

Successful response

​
code
integer
Example:

0

​
message
string
Example:

"success"

​
data
object[]
Example:
[
  {
    "symbol": "700.HK",
    "name_cn": "腾讯控股",
    "name_en": "TENCENT",
    "name_hk": "騰訊控股",
    "exchange": "SEHK",
    "currency": "HKD",
    "lot_size": 100,
    "total_shares": 9106356125,
    "circulating_shares": 9106356125,
    "hk_shares": 9106356125,
    "eps": "23.013927604754377",
    "eps_ttm": "26.2097750997138276",
    "bps": "140.9780051897266427",
    "dividend_yield": "4.5408485490127919",
    "stock_derivatives": [2]
  },
  {
    "symbol": "AAPL.US",
    "name_cn": "苹果",
    "name_en": "Apple Inc.",
    "name_hk": "蘋果",
    "exchange": "NASD",
    "currency": "USD",
    "lot_size": 1,
    "total_shares": 14681140000,
    "circulating_shares": 14656175336,
    "eps": "7.6295165089359546",
    "eps_ttm": "8.0223334155249524",
    "bps": "6.0070267022860623",
    "dividend_yield": "1.04",
    "stock_derivatives": [1]
  },
  {
    "symbol": "000001.SZ",
    "name_cn": "平安银行",
    "name_en": "PAB",
    "name_hk": "平安銀行",
    "exchange": "SZSE",
    "currency": "CNY",
    "lot_size": 100,
    "total_shares": 19405918198,
    "circulating_shares": 19405762053,
    "eps": "2.146707",
    "eps_ttm": "2.2218995030311835",
    "bps": "23.0845557231179667",
    "dividend_yield": "0.5980134452589843"
  }
]