Ticker Snapshot

Market Ticker

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

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

fetch('https://api.tickdb.ai/v1/market/ticker', 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",
  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/ticker"

	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/ticker")

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": "700.HK",
      "last_price": "543",
      "volume_24h": "11205874",
      "high_24h": "557",
      "low_24h": "543",
      "price_change_24h": "-9",
      "price_change_percent_24h": "-1.63",
      "timestamp": 1773292807000
    },
    {
      "symbol": "AAPL.US",
      "last_price": "260.81",
      "volume_24h": "26218927",
      "high_24h": "262.13",
      "low_24h": "259.55",
      "price_change_24h": "-0.02",
      "price_change_percent_24h": "-0.01",
      "timestamp": 1773259201000
    }
  ]
}

GET

market

ticker

Market Ticker

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

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

fetch('https://api.tickdb.ai/v1/market/ticker', 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",
  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/ticker"

	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/ticker")

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": "700.HK",
      "last_price": "543",
      "volume_24h": "11205874",
      "high_24h": "557",
      "low_24h": "543",
      "price_change_24h": "-9",
      "price_change_percent_24h": "-1.63",
      "timestamp": 1773292807000
    },
    {
      "symbol": "AAPL.US",
      "last_price": "260.81",
      "volume_24h": "26218927",
      "high_24h": "262.13",
      "low_24h": "259.55",
      "price_change_24h": "-0.02",
      "price_change_percent_24h": "-0.01",
      "timestamp": 1773259201000
    }
  ]
}

Notes

Maximum 50 symbols per request
Timestamp in milliseconds (UTC)

Supported Markets

Forex, Metals, Indices, US Stocks, HK Stocks, A-Shares, China Futures, Crypto Examples:

Forex: EURUSD, GBPUSD, USDJPY
Metals: XAUUSD, XAGUSD
Indices: SPX, NDX, DJI
US Stocks: AAPL.US, TSLA.US, MSFT.US
HK Stocks: 700.HK, 9988.HK, 3690.HK
A-Shares: 600519.SH, 000001.SZ, 920186.BJ
China Futures: BU2609, IC2606, AP8888
Crypto: BTCUSDT, ETHUSDT, ADAUSDT

Request Parameters

Parameter	Required	Description
symbols	Yes	Trading symbol codes, comma-separated, max 50
type	No	Symbol 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`, `futures`

Response Fields

Field	Description
symbol	Trading Symbol
name	Product name, when available
type	Product type
last_price	Last traded price
bid_price	Best bid price, when available
ask_price	Best ask price, when available
volume_24h	24-hour trading volume
high_24h	24-hour highest price
low_24h	24-hour lowest price
price_change_24h	24-hour price change
price_change_percent_24h	24-hour price change percentage
timestamp	Data timestamp (milliseconds, UTC)

Authorizations

X-API-Key

string

header

required

Query Parameters

symbols

string

default:700.HK,AAPL.US

required

Comma-separated symbols (max 50)

Example:

"700.HK,AAPL.US"

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,

futures

Example:

"stock"

Response

200 - application/json

Successful response

code

integer

Example:

0

message

string

Example:

"success"

data

object[]

Show child attributes

Example:

[
  {
    "symbol": "700.HK",
    "last_price": "543",
    "volume_24h": "11205874",
    "high_24h": "557",
    "low_24h": "543",
    "price_change_24h": "-9",
    "price_change_percent_24h": "-1.63",
    "timestamp": 1773292807000
  },
  {
    "symbol": "AAPL.US",
    "last_price": "260.81",
    "volume_24h": "26218927",
    "high_24h": "262.13",
    "low_24h": "259.55",
    "price_change_24h": "-0.02",
    "price_change_percent_24h": "-0.01",
    "timestamp": 1773259201000
  }
]

Introduction

Getting Started

REST API

WebSocket Docs

Reference

Notes

Supported Markets

Request Parameters

Response Fields

Authorizations

Query Parameters

Response

​Notes

​Supported Markets

​Request Parameters

​Response Fields

Authorizations

Query Parameters

Response

Notes

Supported Markets

Request Parameters

Response Fields