跳转到主要内容
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"
        }
      ]
    }
  ]
}

​
注意事项

  • 本接口返回当前周期内正在形成的K线数据，数据会随着成交持续更新
  • 适用于实时行情图表展示、当前价格监控、分时动态更新
  • 不建议用于历史回测、技术指标统计、固定数据存储
  • 若需查询已结束周期的数据，请使用历史K线：/v1/market/kline

​
支持的市场

外汇、贵金属、指数、美股、港股、A股、加密货币 示例：
  • 外汇：EURUSD、GBPUSD、USDJPY
  • 贵金属：XAUUSD、XAGUSD
  • 指数：SPX、NDX、DJI
  • 美股：AAPL.US、TSLA.US、MSFT.US
  • 港股：700.HK、9988.HK、3690.HK
  • A股：600519.SH、000001.SZ、920186.BJ
  • 加密货币：BTCUSDT、ETHUSDT、ADAUSDT

​
请求参数

参数名是否必须描述
symbols是交易产品代码，多个用逗号分隔，例如：AAPL.US,00700.HK
interval是K线周期，可选值：1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M
type否产品类型，可选。代码无歧义时无需传递；若返回 AMBIGUOUS_SYMBOL 错误，按提示传入对应值即可。可选值：stock、indices、crypto、forex

​
返回字段说明

字段说明
symbol交易产品
intervalK线周期
klinesK线数据数组
└─ timeK线时间戳（毫秒）
└─ open开盘价
└─ high最高价
└─ low最低价
└─ close收盘价
└─ volume成交量
└─ quote_volume成交额

授权

​
X-API-Key
string
header
必填

查询参数

​
symbols
string
默认值:AAPL.US,00700.HK
必填

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

示例:

"AAPL.US,00700.HK"

​
interval
enum<string>
默认值:3m
必填

K-line interval

可用选项:
1m,
3m,
5m,
15m,
30m,
1h,
2h,
4h,
1d,
1w,
1M
示例:

"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

可用选项:
stock,
indices,
crypto,
forex
示例:

"stock"

响应

Successful response

​
code
integer
示例:

0

​
message
string
示例:

"success"

​
data
object[]
示例:
[
  {
    "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"
      }
    ]
  }
]