跳轉到主要內容
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[]