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
    }
  ]
}

​
Notes

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

​
Supported Markets

US Stocks, HK Stocks, Crypto Examples:
  • US Stocks: AAPL.US, TSLA.US, MSFT.US
  • HK Stocks: 700.HK, 9988.HK, 3690.HK
  • Crypto: BTCUSDT, ETHUSDT, ADAUSDT

​
Request Parameters

ParameterRequiredDescription
symbolYesTrading symbol code
limitNoNumber of trades, default 100, max 1000
typeNoSymbol type, optional. Not required when the symbol is unambiguous; if the API returns an AMBIGUOUS_SYMBOL error, pass the value as indicated. Values: stock, indices, crypto, forex

​
Response Fields

FieldDescription
idTrade ID
priceTrade execution price
quantityTrade volume
sideTrade direction (buy/sell)
timestampTrade execution time (milliseconds, UTC)

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
symbol
string
default:700.HK
required

Trading symbol

Example:

"700.HK"

​
limit
integer

Number of trades (default 100, max 1000)

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

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

Available options:
stock,
indices,
crypto,
forex
Example:

"stock"

Response

200 - application/json

Successful response

​
code
integer
Example:

0

​
message
string
Example:

"success"

​
data
object[]