Skip to main content
GET
/
v1
/
market
/
calc-index
Market Metrics
curl --request GET \
  --url https://api.tickdb.ai/v1/market/calc-index \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "700.HK",
      "last_done": "547.5",
      "change_val": "-4.5",
      "change_rate": "-0.0082",
      "volume": "16521084",
      "turnover": "0.0018",
      "ytd_change_rate": "-0.086",
      "turnover_rate": "0.18",
      "total_market_value": "4985729978437.5",
      "capital_flow": "-277985600",
      "amplitude": "0.0281",
      "volume_ratio": "0.47",
      "pe_ttm_ratio": "20.89",
      "pb_ratio": "3.88",
      "dividend_ratio_ttm": "0.83",
      "five_day_change_rate": "0.0906",
      "ten_day_change_rate": "0.0693",
      "half_year_change_rate": "-0.1492",
      "five_minutes_change_rate": "0"
    }
  ]
}

​
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

Field NameDescription
symbolTrading Symbol
last_doneLast Price
change_valChange Value
change_rateChange Rate
volumeVolume
turnoverTurnover
ytd_change_rateYTD Change Rate
turnover_rateTurnover Rate
total_market_valueTotal Market Value
capital_flowCapital Flow
amplitudeAmplitude
volume_ratioVolume Ratio
pe_ttm_ratioP/E Ratio (TTM)
pb_ratioP/B Ratio
dividend_ratio_ttmDividend Yield (TTM)
five_day_change_rate5-Day Change Rate
ten_day_change_rate10-Day Change Rate
half_year_change_rateHalf-Year Change Rate
five_minutes_change_rate5-Minute Change Rate

​
Notes

  • Metrics data is calculated based on real-time quotes and historical data

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
symbols
string
default:700.HK
required

Comma-separated stock symbols (max 50)

Example:

"700.HK,AAPL.US"

​
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",
    "last_done": "547.5",
    "change_val": "-4.5",
    "change_rate": "-0.0082",
    "volume": "16521084",
    "turnover": "0.0018",
    "ytd_change_rate": "-0.086",
    "turnover_rate": "0.18",
    "total_market_value": "4985729978437.5",
    "capital_flow": "-277985600",
    "amplitude": "0.0281",
    "volume_ratio": "0.47",
    "pe_ttm_ratio": "20.89",
    "pb_ratio": "3.88",
    "dividend_ratio_ttm": "0.83",
    "five_day_change_rate": "0.0906",
    "ten_day_change_rate": "0.0693",
    "half_year_change_rate": "-0.1492",
    "five_minutes_change_rate": "0"
  }
]