Back to Details

htx-spot-market

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

HTX Spot Market

HTX现货市场

Public spot market data from HTX. No authentication required. Agent may call these endpoints freely without user confirmation.
来自HTX的公开现货市场数据。无需身份验证。 Agent可无需用户确认自由调用这些接口。

When to use this skill

何时使用该Skill

Load this skill when the user asks about:
  • Current price of a spot symbol (e.g. 
    btcusdt
    , 
    ethusdt
    )
  • K-line / OHLC data, chart data, candles
  • Order book depth, bid/ask, best bid/offer
  • Recent trades, trade history
  • Listed symbols, supported currencies, chain info
  • Server time, market status (open / halted / cancel-only)
  • 24h market overview, top gainers/losers
当用户询问以下内容时加载此Skill：
  • 现货交易对的当前价格（例如 
    btcusdt
    、
    ethusdt
    ）
  • K线/OHLC数据、图表数据、蜡烛图
  • 订单簿深度、买卖盘、最优买卖报价
  • 最新交易记录、交易历史
  • 已上线交易对、支持的币种、链信息
  • 服务器时间、市场状态（开放/暂停/仅允许撤单）
  • 24小时市场概览、涨幅/跌幅榜

Underlying tool

底层工具

This skill drives the 
htx-cli
binary. The binary must be on 
$PATH
(or at 
$HTX_CLI_BIN
). Binary location in the source repo:
htx-cli/agent-harness-go/bin/htx-cli
Always pass 
--json
so output is machine-parseable.
该Skill驱动 
htx-cli
二进制文件。该二进制文件必须位于 
$PATH
（或 
$HTX_CLI_BIN
）路径下。源码仓库中的二进制文件位置：
htx-cli/agent-harness-go/bin/htx-cli
请始终传递 
--json
参数，以便输出可被机器解析。

Endpoint catalog (15)

接口目录（15个）

Reference Data (7)

参考数据（7个）

#MethodEndpointCLI invocationDescription
1GET
/v2/market-status
htx-cli spot market status --json
Market status (normal / halted / cancel-only)
2GET
/v2/settings/common/symbols
htx-cli spot market symbols --json
All trading pair configuration
3GET
/v2/settings/common/currencies
htx-cli spot market currencies --json
All currency configuration
4GET
/v1/settings/common/symbols
htx-cli spot call GET /v1/settings/common/symbols --json
Symbol precision info
5GET
/v1/settings/common/market-symbols
htx-cli spot call GET /v1/settings/common/market-symbols --json
Spot market symbol config
6GET
/v2/reference/currencies
htx-cli spot call GET /v2/reference/currencies --json
Currency + chain info
7GET
/v1/common/timestamp
htx-cli spot market timestamp --json
Server timestamp (ms)
序号请求方法接口地址CLI调用命令描述
1GET
/v2/market-status
htx-cli spot market status --json
市场状态（正常/暂停/仅允许撤单）
2GET
/v2/settings/common/symbols
htx-cli spot market symbols --json
所有交易对配置信息
3GET
/v2/settings/common/currencies
htx-cli spot market currencies --json
所有币种配置信息
4GET
/v1/settings/common/symbols
htx-cli spot call GET /v1/settings/common/symbols --json
交易对精度信息
5GET
/v1/settings/common/market-symbols
htx-cli spot call GET /v1/settings/common/market-symbols --json
现货市场交易对配置
6GET
/v2/reference/currencies
htx-cli spot call GET /v2/reference/currencies --json
币种+链信息
7GET
/v1/common/timestamp
htx-cli spot market timestamp --json
服务器时间戳（毫秒）

Market Data (8)

市场数据（8个）

#MethodEndpointCLI invocationDescription
1GET
/market/history/kline
htx-cli spot market klines <symbol> --period <period> [--size N] --json
K-line (OHLC). Periods: 
1min,5min,15min,30min,60min,4hour,1day,1mon,1week,1year
2GET
/market/detail
htx-cli spot market ticker <symbol> --json
Latest ticker (price / volume / 24h stats)
3GET
/market/tickers
htx-cli spot market tickers --json
All-market ticker snapshot
4GET
/market/depth
htx-cli spot market depth <symbol> [--type step0] --json
Order book depth
5GET
/market/trade
htx-cli spot market trades <symbol> --json
Latest trades
6GET
/market/history/trade
htx-cli spot call GET /market/history/trade --query symbol=<symbol>&size=<N> --json
Historical trades
7GET
/market/overview
htx-cli spot call GET /market/overview --json
24h market overview
8GET
/market/orderbook
htx-cli spot call GET /market/orderbook --query symbol=<symbol> --json
Full order book
序号请求方法接口地址CLI调用命令描述
1GET
/market/history/kline
htx-cli spot market klines <symbol> --period <period> [--size N] --json
K线（OHLC）。周期选项：
1min,5min,15min,30min,60min,4hour,1day,1mon,1week,1year
2GET
/market/detail
htx-cli spot market ticker <symbol> --json
最新行情报价（价格/成交量/24小时统计数据）
3GET
/market/tickers
htx-cli spot market tickers --json
全市场行情报价快照
4GET
/market/depth
htx-cli spot market depth <symbol> [--type step0] --json
订单簿深度
5GET
/market/trade
htx-cli spot market trades <symbol> --json
最新交易记录
6GET
/market/history/trade
htx-cli spot call GET /market/history/trade --query symbol=<symbol>&size=<N> --json
历史交易记录
7GET
/market/overview
htx-cli spot call GET /market/overview --json
24小时市场概览
8GET
/market/orderbook
htx-cli spot call GET /market/orderbook --query symbol=<symbol> --json
完整订单簿

Typical queries

典型查询示例

  • "What's the current BTC price?" → 
    htx-cli spot market ticker btcusdt --json
  • "ETH/USDT 4-hour klines" → 
    htx-cli spot market klines ethusdt --period 4hour --size 200 --json
  • "SOL order book, best bid/ask" → 
    htx-cli spot market depth solusdt --type step0 --json
  • "Top gainers in the last 24h?" → 
    htx-cli spot market tickers --json
    then sort client-side by change %
  • "Is the market open?" → 
    htx-cli spot market status --json
  • "BTC当前价格是多少？" → 
    htx-cli spot market ticker btcusdt --json
  • "ETH/USDT的4小时K线" → 
    htx-cli spot market klines ethusdt --period 4hour --size 200 --json
  • "SOL的订单簿，最优买卖报价" → 
    htx-cli spot market depth solusdt --type step0 --json
  • "过去24小时涨幅榜？" → 
    htx-cli spot market tickers --json
    然后在客户端按涨跌幅百分比排序
  • "市场是否开放？" → 
    htx-cli spot market status --json

Notes for the agent

Agent注意事项

  • All endpoints here are public — never attach 
    AccessKeyId
    or signatures.
  • Emit 
    --json
    on every call so you can parse the result.
  • When the user says a symbol like "BTC", map it to 
    btcusdt
    unless they name another quote currency.
  • Klines: default to 
    1day
    size 
    100
    if the user doesn't specify.
  • For "full orderbook vs depth": use 
    depth
    for top-of-book / small N levels; use 
    orderbook
    for full snapshot.
  • 此处所有接口均为公开接口——切勿附加 
    AccessKeyId
    或签名。
  • 每次调用都要加上 
    --json
    参数，以便解析结果。
  • 当用户提及类似"BTC"的币种时，默认映射为 
    btcusdt
    ，除非用户指定了其他计价币种。
  • K线：如果用户未指定，默认使用
    1day
    周期，数量为
    100
    。
  • 关于"完整订单簿 vs 深度"：若仅需顶部订单/少量层级，使用
    depth
    ；若需完整快照，使用
    orderbook
    。

References

参考资料

  • references/symbols.md
    — symbol / currency quick reference
  • references/symbols.md
    — 交易对/币种快速参考文档