Skip to main content
GET
/
v1
/
market
/
ticker
Market Ticker
curl --request GET \
  --url https://api.tickdb.ai/v1/market/ticker \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "700.HK",
      "last_price": "543",
      "volume_24h": "11205874",
      "high_24h": "557",
      "low_24h": "543",
      "price_change_24h": "-9",
      "price_change_percent_24h": "-1.63",
      "timestamp": 1773292807000
    },
    {
      "symbol": "AAPL.US",
      "last_price": "260.81",
      "volume_24h": "26218927",
      "high_24h": "262.13",
      "low_24h": "259.55",
      "price_change_24h": "-0.02",
      "price_change_percent_24h": "-0.01",
      "timestamp": 1773259201000
    }
  ]
}

​
Notes

  • Maximum 50 symbols per request
  • Timestamp in milliseconds (UTC)

​
Supported Markets

Forex, Metals, Indices, US Stocks, HK Stocks, A-Shares, Crypto Examples:
  • Forex: EURUSD, GBPUSD, USDJPY
  • Metals: XAUUSD, XAGUSD
  • Indices: SPX, NDX, DJI
  • US Stocks: AAPL.US, TSLA.US, MSFT.US
  • HK Stocks: 700.HK, 9988.HK, 3690.HK
  • A-Shares: 600519.SH, 000001.SZ, 920186.BJ
  • Crypto: BTCUSDT, ETHUSDT, ADAUSDT

​
Request Parameters

ParameterRequiredDescription
symbolsYesTrading 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
last_priceLast traded price
volume_24h24-hour trading volume
high_24h24-hour highest price
low_24h24-hour lowest price
price_change_24h24-hour price change
price_change_percent_24h24-hour price change percentage
timestampData timestamp (milliseconds, UTC)

Authorizations

​
X-API-Key
string
header
required

Query Parameters

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

Comma-separated 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_price": "543",
    "volume_24h": "11205874",
    "high_24h": "557",
    "low_24h": "543",
    "price_change_24h": "-9",
    "price_change_percent_24h": "-1.63",
    "timestamp": 1773292807000
  },
  {
    "symbol": "AAPL.US",
    "last_price": "260.81",
    "volume_24h": "26218927",
    "high_24h": "262.13",
    "low_24h": "259.55",
    "price_change_24h": "-0.02",
    "price_change_percent_24h": "-0.01",
    "timestamp": 1773259201000
  }
]