A股全量行情

A股全量行情

curl --request GET \
  --url https://api.tickdb.ai/v1/market/ticker/cn-stock \
  --compressed \
  --header 'Accept-Encoding: <accept-encoding>' \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.tickdb.ai/v1/market/ticker/cn-stock"

headers = {
    "Accept-Encoding": "<accept-encoding>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.tickdb.ai/v1/market/ticker/cn-stock', 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/ticker/cn-stock",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept-Encoding: <accept-encoding>",
    "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/ticker/cn-stock"

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

	req.Header.Add("Accept-Encoding", "<accept-encoding>")
	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/ticker/cn-stock")

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

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

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

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "<string>",
      "last_price": "<string>",
      "timestamp": 123,
      "name": "<string>",
      "type": "stock",
      "category": "sh_stock",
      "open": "<string>",
      "prev_close": "<string>",
      "volume_24h": "<string>",
      "quote_volume_24h": "<string>",
      "high_24h": "<string>",
      "low_24h": "<string>",
      "price_change_24h": "<string>",
      "price_change_percent_24h": "<string>"
    }
  ]
}

GET

market

ticker

cn-stock

A股全量行情

curl --request GET \
  --url https://api.tickdb.ai/v1/market/ticker/cn-stock \
  --compressed \
  --header 'Accept-Encoding: <accept-encoding>' \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.tickdb.ai/v1/market/ticker/cn-stock"

headers = {
    "Accept-Encoding": "<accept-encoding>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://api.tickdb.ai/v1/market/ticker/cn-stock', 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/ticker/cn-stock",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept-Encoding: <accept-encoding>",
    "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/ticker/cn-stock"

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

	req.Header.Add("Accept-Encoding", "<accept-encoding>")
	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/ticker/cn-stock")

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

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

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

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "<string>",
      "last_price": "<string>",
      "timestamp": 123,
      "name": "<string>",
      "type": "stock",
      "category": "sh_stock",
      "open": "<string>",
      "prev_close": "<string>",
      "volume_24h": "<string>",
      "quote_volume_24h": "<string>",
      "high_24h": "<string>",
      "low_24h": "<string>",
      "price_change_24h": "<string>",
      "price_change_percent_24h": "<string>"
    }
  ]
}

套餐权限

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

注意事项

无需传入请求参数，一次返回当前可用的全部行情记录，不分页。
返回范围包括沪深京股票、ETF、指数和债券，可通过 type 和 category 判断产品类型。
响应数据量较大，客户端必须启用 HTTP 响应压缩，并声明支持 gzip、br 或 zstd 中的至少一种格式；未启用压缩时可能返回 406。
timestamp 为每条行情的数据时间，使用 Unix 毫秒时间戳。
open、prev_close 在对应数据不可用时不会返回。

支持的市场

市场	示例
A股	600519.SH, 000001.SZ, 920186.BJ

请求参数

无。

请求示例

curl --compressed \
  -H "X-API-Key: YOUR_API_KEY" \
  "https://api.tickdb.ai/v1/market/ticker/cn-stock"

代码示例

以下 Node.js 22+ 示例声明支持三种压缩格式，并根据响应中的 Content-Encoding 自动选择解压方式。

const https = require("node:https");
const zlib = require("node:zlib");

const decompressors = {
  gzip: zlib.gunzipSync,
  br: zlib.brotliDecompressSync,
  zstd: zlib.zstdDecompressSync,
};

const request = https.get("https://api.tickdb.ai/v1/market/ticker/cn-stock", {
  headers: {
    "X-API-Key": process.env.TICKDB_API_KEY,
    "Accept-Encoding": "gzip, br, zstd",
  },
}, (response) => {
  const chunks = [];
  response.on("data", (chunk) => chunks.push(chunk));
  response.on("end", () => {
    if (response.statusCode !== 200) {
      throw new Error(`请求失败：${response.statusCode}`);
    }

    const encoding = response.headers["content-encoding"];
    const decompress = decompressors[encoding];
    if (!decompress) {
      throw new Error(`不支持的压缩格式：${encoding}`);
    }

    const body = decompress(Buffer.concat(chunks));
    const result = JSON.parse(body.toString("utf8"));
    console.log(`返回 ${result.data.length} 条行情`);
    console.log(result.data[0]);
  });
});

request.on("error", console.error);

返回字段说明

字段	说明
code	响应码，`0` 表示成功。
message	响应消息。
data	A股市场全量行情数组。
└─ symbol	交易产品代码，包含 `.SH`、`.SZ` 或 `.BJ` 市场后缀。
└─ name	产品名称。
└─ type	产品类型：`stock` 股票类产品、`indices` 指数。
└─ category	产品细分类别，取值说明见下表。
└─ last_price	最新成交价。
└─ open	当日开盘价；数据不可用时不返回。
└─ prev_close	上一交易日收盘价；数据不可用时不返回。
└─ volume_24h	当日累计成交量。
└─ quote_volume_24h	当日累计成交额。
└─ high_24h	当日最高价。
└─ low_24h	当日最低价。
└─ price_change_24h	相对昨收的价格变化。
└─ price_change_percent_24h	相对昨收的价格变化百分比。
└─ timestamp	Unix 时间戳，单位为毫秒。

category 取值

取值	说明
`sh_stock`	上交所股票。
`sz_stock`	深交所股票。
`bj_stock`	北交所股票。
`etf`	ETF。
`cn_index`	A股市场指数。
`cn_bond`	A股市场债券。

授权

X-API-Key

string

header

必填

请求头

Accept-Encoding

enum<string>

默认值:gzip

必填

全量行情响应必须启用压缩，支持 gzip、br 和 zstd，至少选择一种；默认使用兼容性较好的 gzip。

可用选项:

gzip,

br,

zstd

响应

请求成功。

code

integer

必填

示例:

0

message

string

必填

示例:

"success"

data

object[]

必填

Show child attributes

介绍

入门指南

REST API

WebSocket 文档

参考

套餐权限

注意事项

支持的市场

请求参数

请求示例

代码示例

返回字段说明

category 取值

授权

请求头

响应

​套餐权限

​注意事项

​支持的市场

​请求参数

​请求示例

​代码示例

​返回字段说明

​category 取值

授权

请求头

响应

套餐权限

注意事项

支持的市场

请求参数

请求示例

代码示例

返回字段说明

category 取值