Skip to main content
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
    }
  ]
}
GET /v1/market/trades

​
Overview

Retrieve recent trade execution records for a trading symbol.

​
Multi-Market Examples

Crypto: BTCUSDT, ETHUSDT, ADAUSDT US Stocks: AAPL.US, TSLA.US, MSFT.US HK Stocks: 700.HK, 9988.HK, 3690.HK 
curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/trades?symbol=700.HK&limit=5"

​
Example Response

{
    "code": 0,
    "message": "success",
    "data": {
        "symbol": "700.HK",
        "trades": [
            {
                "id": "0",
                "price": "625.500",
                "quantity": "200",
                "side": "sell",
                "timestamp": 1768274130
            },
            {
                "id": "0",
                "price": "625.500",
                "quantity": "100",
                "side": "sell",
                "timestamp": 1768274133
            },
            {
                "id": "0",
                "price": "625.250",
                "quantity": "100",
                "side": "buy",
                "timestamp": 1768274137
            },
            {
                "id": "0",
                "price": "625.500",
                "quantity": "100",
                "side": "sell",
                "timestamp": 1768274138
            },
            {
                "id": "0",
                "price": "625.500",
                "quantity": "300",
                "side": "sell",
                "timestamp": 1768274140
            }
        ]
    }
}

​
Notes

  • side: buy / sell
  • timestamp in milliseconds (UTC)

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
symbol
string
required

Trading symbol

Example:

"BTCUSDT"

​
limit
integer
default:50

Number of trades (default 50, max 200)

Required range: 1 <= x <= 200
Example:

100

Response

200 - application/json

Successful response

​
code
integer
Example:

0

​
message
string
Example:

"success"

​
data
object[]