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": 1768942620000,
          "open": "246.035",
          "high": "246.93",
          "low": "245.58",
          "close": "246.7",
          "volume": "3608863",
          "quote_volume": "889235872.74"
        }
      ]
    }
  ]
}
GET /v1/market/kline/latest

โ€‹
๐Ÿ“Œ Description

This endpoint returns K-line data for the current time period being formed.
  • Data updates continuously with trades
  • When the current period ends, this K-line becomes historical
  • For completed period data, use ๐Ÿ‘‰ Historical K-Line: /v1/market/kline

โ€‹
๐Ÿง  Lifecycle Explanation

Period Start โ†’ Real-time Updates โ†’ Period End โ†’ Becomes Historical Data Real-time K-line represents data in โ€œongoing periodโ€ status.

โ€‹
๐ŸŽฏ Use Cases

  • Real-time chart display
  • Current price monitoring
  • Intraday dynamic updates

โ€‹
โš ๏ธ Not Recommended For

  • Historical backtesting
  • Technical indicator statistics
  • Fixed data storage

โ€‹
๐Ÿ” Difference from Historical K-Line

ItemReal-time K-LineHistorical K-Line
Time RangeCurrent periodCompleted periods
Data StatusContinuously updatingFixed
Use CaseReal-time displayBacktesting / Analysis
UpdatesYesNo

โ€‹
Multi-Market Examples

Forex: EURUSD, GBPUSD, USDJPY
Precious Metals: XAUUSD, XAGUSD
US Stocks: AAPL.US, TSLA.US, MSFT.US
Hong Kong Stocks: 700.HK, 9988.HK, 3690.HK
Cryptocurrency: BTCUSDT, ETHUSDT, ADAUSDT

โ€‹
Supported Time Intervals

  • Minutes: 1m, 5m, 15m, 30m
  • Hours: 1h, 4h, 12h
  • Days: 1d, 1w, 1M

โ€‹
Request Example

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/kline/latest?symbols=AAPL.US,00700.HK&interval=3m"

โ€‹
Response Example

{
    "code": 0,
    "message": "success",
    "data": [
        {
            "symbol": "AAPL.US",
            "interval": "3m",
            "klines": [
                {
                    "time": 1768942620000,
                    "open": "246.035",
                    "high": "246.93",
                    "low": "245.58",
                    "close": "246.7",
                    "volume": "3608863",
                    "quote_volume": "889235872.74"
                }
            ]
        },
        {
            "symbol": "00700.HK",
            "interval": "3m",
            "klines": [
                {
                    "time": 1768982400000,
                    "open": "602",
                    "high": "602",
                    "low": "601.5",
                    "close": "601.5",
                    "volume": "35900",
                    "quote_volume": "21599833.33"
                }
            ]
        }
    ]
}

Authorizations

โ€‹
X-API-Key
string
header
required

Query Parameters

โ€‹
symbols
string
required

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

Example:

"AAPL.US,00700.HK"

โ€‹
interval
enum<string>
required

K-line interval

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

"3m"

Response

Successful response

โ€‹
code
integer
Example:

0

โ€‹
message
string
Example:

"success"

โ€‹
data
object[]