跳转到主要内容
GET
/
v1
/
symbols
/
available
Available Symbols
curl --request GET \
  --url https://api.tickdb.ai/v1/symbols/available \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": {
    "symbols": [
      {
        "symbol": "BTCUSDT",
        "market": "CRYPTO",
        "base_asset": "BTC",
        "quote_asset": "USDT",
        "status": "active"
      }
    ],
    "total": 1250,
    "page": 1,
    "limit": 50
  }
}
GET /v1/symbols/available

概述

查询 TickDB 支持的所有可用交易品种。

支持的市场

  • CRYPTO - 加密货币交易对
  • US - 美国股票市场
  • HK - 香港证券交易所
  • FX - 外汇市场
  • INDEX - 市场指数
  • METAL - 贵金属
curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/symbols/available?market=FOREX&limit=5"

响应示例

{
    "products": [
        {
            "symbol": "AUDBRL",
            "name": "AUDBRL",
            "market": "FOREX",
            "product_type": "forex",
            "currency": "USD",
            "is_active": true,
            "updated_at": "2026-01-13T11:19:59+08:00"
        },
        {
            "symbol": "AUDCAD",
            "name": "AUDCAD",
            "market": "FOREX",
            "product_type": "forex",
            "currency": "USD",
            "is_active": true,
            "updated_at": "2026-01-13T11:19:59+08:00"
        },
        {
            "symbol": "AUDCHF",
            "name": "AUDCHF",
            "market": "FOREX",
            "product_type": "forex",
            "currency": "USD",
            "is_active": true,
            "updated_at": "2026-01-13T11:19:59+08:00"
        },
        {
            "symbol": "AUDCNY",
            "name": "AUDCNY",
            "market": "FOREX",
            "product_type": "forex",
            "currency": "USD",
            "is_active": true,
            "updated_at": "2026-01-13T11:19:59+08:00"
        },
        {
            "symbol": "AUDCZK",
            "name": "AUDCZK",
            "market": "FOREX",
            "product_type": "forex",
            "currency": "USD",
            "is_active": true,
            "updated_at": "2026-01-13T11:19:59+08:00"
        }
    ],
    "summary": {
        "total_products": 434,
        "by_market": {
            "FOREX": 434
        },
        "last_updated": "2026-01-13T11:19:59+08:00"
    },
    "cache_info": {
        "from_cache": true,
        "cached_at": "2026-01-13T11:19:59+08:00",
        "expires_at": "2026-01-13T11:49:59+08:00"
    },
    "pagination": {
        "limit": 5,
        "offset": 0,
        "count": 5
    }
}

注意事项

  • 市场代码不区分大小写
  • 交易品种命名规则请参阅数据规范文档

授权

X-API-Key
string
header
必填

查询参数

market
enum<string>

Market filter

可用选项:
CRYPTO,
US,
HK,
FX,
INDEX,
METAL
示例:

"CRYPTO"

limit
integer
默认值:100

Number of symbols (default 100, max 500)

必填范围: 1 <= x <= 500
示例:

50

page
integer
默认值:1

Page number for pagination

必填范围: x >= 1
示例:

1

响应

200 - application/json

Successful response

code
integer
示例:

0

message
string
示例:

"success"

data
object