跳转到主要内容
GET
/
v1
/
market
/
trades
Recent Trades
curl --request GET \
  --url https://api.tickdb.ai/v1/market/trades \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": "12345678",
      "price": "43150.00",
      "quantity": "0.025",
      "side": "buy",
      "timestamp": 1703123456789
    }
  ]
}

​
注意事项

  • side：买入（buy）/ 卖出（sell）
  • 时间戳单位为毫秒（UTC）

​
支持的市场

美股、港股、加密货币 示例：
  • 美股：AAPL.US、TSLA.US、MSFT.US
  • 港股：700.HK、9988.HK、3690.HK
  • 加密货币：BTCUSDT、ETHUSDT、ADAUSDT

​
请求参数

参数名是否必须描述
symbol是交易产品代码
limit否返回成交记录数，默认100，最大1000
type否产品类型，可选。代码无歧义时无需传递；若返回 AMBIGUOUS_SYMBOL 错误，按提示传入对应值即可。可选值：stock、indices、crypto、forex

​
返回字段说明

字段说明
id成交ID
price成交价格
quantity成交数量
side成交方向（买入/卖出）
timestamp成交时间（毫秒时间戳，UTC）

授权

​
X-API-Key
string
header
必填

查询参数

​
symbol
string
默认值:700.HK
必填

Trading symbol

示例:

"700.HK"

​
limit
integer

Number of trades (default 100, max 1000)

必填范围: 1 <= x <= 1000
示例:

100

​
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"

响应

200 - application/json

Successful response

​
code
integer
示例:

0

​
message
string
示例:

"success"

​
data
object[]