Skip to main content
GET
/
v1
/
market
/
kline
/
latest
Latest K-line Data
curl --request GET \
  --url https://api.tickdb.ai/v1/market/kline/latest \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "AAPL.US",
      "interval": "3m",
      "klines": [
        {
          "time": 1773259020000,
          "open": "260.86",
          "high": "261.05",
          "low": "260.7",
          "close": "260.81",
          "volume": "963419",
          "quote_volume": "251311057.55"
        }
      ]
    },
    {
      "symbol": "00700.HK",
      "interval": "3m",
      "klines": [
        {
          "time": 1773293400000,
          "open": "542.5",
          "high": "544.5",
          "low": "542",
          "close": "544.5",
          "volume": "80300",
          "quote_volume": "43656433.33"
        }
      ]
    }
  ]
}

​
Notes

  • This endpoint returns K-line data for the current period being formed, data updates continuously with trades
  • Suitable for real-time chart display, current price monitoring, and intraday dynamic updates
  • Not recommended for historical backtesting, technical indicator statistics, or fixed data storage
  • For completed period data, use Historical K-Line: /v1/market/kline

​
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, e.g., AAPL.US,00700.HK
intervalYesK-line period, options: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M
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
intervalK-line period
klinesK-line data array
└─ timeK-line timestamp (milliseconds)
└─ openOpening price
└─ highHighest price
└─ lowLowest price
└─ closeClosing price
└─ volumeTrading volume
└─ quote_volumeTrading amount

Authorizations

​
X-API-Key
string
header
required

Query Parameters

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

Comma-separated symbols (e.g., AAPL.US,00700.HK)

Example:

"AAPL.US,00700.HK"

​
interval
enum<string>
default:3m
required

K-line interval

Available options:
1m,
3m,
5m,
15m,
30m,
1h,
2h,
4h,
1d,
1w,
1M
Example:

"3m"

​
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

Successful response

​
code
integer
Example:

0

​
message
string
Example:

"success"

​
data
object[]
Example:
[
  {
    "symbol": "AAPL.US",
    "interval": "3m",
    "klines": [
      {
        "time": 1773259020000,
        "open": "260.86",
        "high": "261.05",
        "low": "260.7",
        "close": "260.81",
        "volume": "963419",
        "quote_volume": "251311057.55"
      }
    ]
  },
  {
    "symbol": "00700.HK",
    "interval": "3m",
    "klines": [
      {
        "time": 1773293400000,
        "open": "542.5",
        "high": "544.5",
        "low": "542",
        "close": "544.5",
        "volume": "80300",
        "quote_volume": "43656433.33"
      }
    ]
  }
]