逐笔成交

逐笔成交

curl --request GET \
  --url https://api.tickdb.ai/v1/market/trades \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/market/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tickdb.ai/v1/market/trades",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tickdb.ai/v1/market/trades"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/market/trades")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "BU2609",
    "type": "futures",
    "trades": [
      {
        "id": "1703123456789_0",
        "price": "4315.00",
        "quantity": "2",
        "side": "sell",
        "timestamp": 1703123456789,
        "open_interest_change": 0,
        "position_effect": "short_transfer"
      }
    ]
  }
}

GET

market

trades

逐笔成交

curl --request GET \
  --url https://api.tickdb.ai/v1/market/trades \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/market/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tickdb.ai/v1/market/trades",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tickdb.ai/v1/market/trades"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/market/trades")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "BU2609",
    "type": "futures",
    "trades": [
      {
        "id": "1703123456789_0",
        "price": "4315.00",
        "quantity": "2",
        "side": "sell",
        "timestamp": 1703123456789,
        "open_interest_change": 0,
        "position_effect": "short_transfer"
      }
    ]
  }
}

套餐权限

套餐	可用
免费版	❌
基础版	✅
专业版	✅
全量套餐（A 股、港股、美股）	✅
企业版	✅

注意事项

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

支持的市场

市场	示例
美股	AAPL.US, TSLA.US, MSFT.US
港股	700.HK, 9988.HK, 3690.HK
A股	600519.SH, 000001.SZ, 920186.BJ
中国期货	BU2609, IC2606, AP8888
香港期货	HSI8888, MHI8888, HTI8888
加密货币	BTCUSDT, ETHUSDT, ADAUSDT

请求参数

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

返回字段说明

字段	说明
symbol	交易产品
type	产品类型
trades	成交记录数组
└─ id	成交ID
└─ price	成交价格
└─ quantity	成交数量
└─ side	成交方向（`buy`、`sell` 或 `neutral`）
└─ timestamp	成交时间（毫秒时间戳，UTC）
└─ open_interest_change	持仓变化，仅期货返回
└─ position_effect	持仓影响，仅期货返回；取值见下表

`position_effect` 取值说明

类型	取值
开仓	`long_open`（多开） `short_open`（空开） `both_open`（双开）
平仓	`long_close`（多平） `short_close`（空平） `both_close`（双平）
换手	`long_transfer`（多换） `short_transfer`（空换）

授权

X-API-Key

string

header

必填

查询参数

symbol

string

默认值:700.HK

必填

交易产品代码

示例:

"700.HK"

limit

integer

返回成交记录数，默认100，最大1000

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

示例:

100

type

enum<string>

产品类型，可选。代码无歧义时无需传递；若返回 AMBIGUOUS_SYMBOL 错误，按提示传入对应值即可。可选值：stock、indices、crypto、forex、futures

可用选项:

stock,

indices,

crypto,

forex,

futures

示例:

"stock"

响应

200 - application/json

请求成功。

code

integer

示例:

0

message

string

示例:

"success"

data

object

Show child attributes

介绍

入门指南

REST API

WebSocket 文档

参考

套餐权限

注意事项

支持的市场

请求参数

返回字段说明

`position_effect` 取值说明

授权

查询参数

响应

​套餐权限

​注意事项

​支持的市场

​请求参数

​返回字段说明

​position_effect 取值说明

授权

查询参数

响应

套餐权限

注意事项

支持的市场

请求参数

返回字段说明

`position_effect` 取值说明