htx-futures-market

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Query HTX USDT-M perpetual futures market data — contract info, funding rates, OI, klines, depth, liquidations, sentiment. Mostly public; 6 endpoints require read-permission API key.

2installs

Sourcehtx-exchange/htx-skills-hub

Added on2026-05-07

NPX Install

npx skill4agent add htx-exchange/htx-skills-hub htx-futures-market

SKILL.md Content

View Translation Comparison →

HTX USDT-M Futures Market

USDT-margined perpetual futures market data. Mostly public — a handful of reference endpoints require a read-permission API key. Agent may call all of these freely without user confirmation.

When to use this skill

"BTC perpetual funding rate?"
"ETH futures OI?"
"Long/short ratio from top traders"
"BTC-USDT 4h kline on futures"
"How much liquidation volume today?"
"What are the tier margin requirements for BTC-USDT?"

Underlying tool

Drives

htx-cli

. Binary on

$PATH

or

$HTX_CLI_BIN

. Always

--json

.

For the 6 authenticated reference endpoints, configure credentials once (read permission is enough):

bash

htx-cli config set-key    <AccessKeyId>
htx-cli config set-secret <SecretKey>

Endpoint catalog (36)

Contract & system info — public (14)


htx-cli futures market contract-info [--contract-code <code>] --json
htx-cli futures call GET /linear-swap-api/v1/swap_index --json
htx-cli futures call GET /linear-swap-api/v1/swap_price_limit --json
htx-cli futures call GET /linear-swap-api/v1/swap_open_interest --json
htx-cli futures call GET /linear-swap-api/v1/swap_query_elements --json
htx-cli futures call GET /linear-swap-api/v1/swap_estimated_settlement_price --json
htx-cli futures market system-status --json
htx-cli futures call GET /v1/insurance_fund_info --json
htx-cli futures call GET /v1/insurance_fund_history --json
htx-cli futures call GET /linear-swap-api/v1/swap_timestamp --json
htx-cli futures call GET /heartbeat/ --json
htx-cli futures call GET /linear-swap-ex/market/swap_contract_constituents --json
htx-cli futures market liquidation-orders --contract-code <code> --json
htx-cli futures call GET /linear-swap-api/v1/swap_settlement_records --json

#	Method	Endpoint	CLI invocation	Description
1	GET	`/linear-swap-api/v1/swap_contract_info`	`htx-cli futures market contract-info [--contract-code <code>] --json`	Contract metadata
2	GET	`/linear-swap-api/v1/swap_index`	`htx-cli futures call GET /linear-swap-api/v1/swap_index --json`	Index price
3	GET	`/linear-swap-api/v1/swap_price_limit`	`htx-cli futures call GET /linear-swap-api/v1/swap_price_limit --json`	Price limit (circuit)
4	GET	`/linear-swap-api/v1/swap_open_interest`	`htx-cli futures call GET /linear-swap-api/v1/swap_open_interest --json`	Open interest (OI)
5	GET	`/linear-swap-api/v1/swap_query_elements`	`htx-cli futures call GET /linear-swap-api/v1/swap_query_elements --json`	Contract elements
6	GET	`/linear-swap-api/v1/swap_estimated_settlement_price`	`htx-cli futures call GET /linear-swap-api/v1/swap_estimated_settlement_price --json`	Estimated settlement price
7	GET	`/linear-swap-api/v1/swap_system_status`	`htx-cli futures market system-status --json`	System status (isolated)
8	GET	`/v1/insurance_fund_info`	`htx-cli futures call GET /v1/insurance_fund_info --json`	Insurance fund balance
9	GET	`/v1/insurance_fund_history`	`htx-cli futures call GET /v1/insurance_fund_history --json`	Insurance fund history
10	GET	`/linear-swap-api/v1/swap_timestamp`	`htx-cli futures call GET /linear-swap-api/v1/swap_timestamp --json`	Server timestamp
11	GET	`/heartbeat/`	`htx-cli futures call GET /heartbeat/ --json`	Heartbeat
12	GET	`/linear-swap-ex/market/swap_contract_constituents`	`htx-cli futures call GET /linear-swap-ex/market/swap_contract_constituents --json`	Index constituents
13	GET	`/linear-swap-api/v1/swap_liquidation_orders`	`htx-cli futures market liquidation-orders --contract-code <code> --json`	Liquidation orders
14	GET	`/linear-swap-api/v1/swap_settlement_records`	`htx-cli futures call GET /linear-swap-api/v1/swap_settlement_records --json`	Settlement history

Funding rate & sentiment — public (5)


htx-cli futures market funding-rate <contract-code> --json
htx-cli futures call GET /linear-swap-api/v1/swap_batch_funding_rate --json
htx-cli futures market historical-funding-rate --contract-code <code> --json
htx-cli futures call GET /linear-swap-api/v1/swap_elite_account_ratio --json
htx-cli futures call GET /linear-swap-api/v1/swap_elite_position_ratio --json

#	Method	Endpoint	CLI invocation	Description
1	GET	`/linear-swap-api/v1/swap_funding_rate`	`htx-cli futures market funding-rate <contract-code> --json`	Current funding rate
2	GET	`/linear-swap-api/v1/swap_batch_funding_rate`	`htx-cli futures call GET /linear-swap-api/v1/swap_batch_funding_rate --json`	Batch funding rates
3	GET	`/linear-swap-api/v1/swap_historical_funding_rate`	`htx-cli futures market historical-funding-rate --contract-code <code> --json`	Historical funding rate
4	GET	`/linear-swap-api/v1/swap_elite_account_ratio`	`htx-cli futures call GET /linear-swap-api/v1/swap_elite_account_ratio --json`	Top-account long/short ratio
5	GET	`/linear-swap-api/v1/swap_elite_position_ratio`	`htx-cli futures call GET /linear-swap-api/v1/swap_elite_position_ratio --json`	Top-position long/short ratio

Market data — public (11)


htx-cli futures call GET /linear-swap-ex/market/depth --json
htx-cli futures call GET /linear-swap-ex/market/bbo --json
htx-cli futures call GET /linear-swap-ex/market/history/kline --json
htx-cli futures call GET /linear-swap-ex/market/history/mark_price_kline --json
htx-cli futures call GET /linear-swap-ex/market/detail/merged --json
htx-cli futures market tickers --json
htx-cli futures call GET /linear-swap-ex/market/trade --json
htx-cli futures call GET /linear-swap-ex/market/history/trade --json
htx-cli futures call GET /linear-swap-ex/market/his_open_interest --json
htx-cli futures call GET /linear-swap-ex/market/history/premium_index_kline --json
htx-cli futures call GET /linear-swap-ex/market/history/estimated_rate_kline --json

#	Method	Endpoint	CLI invocation	Description
1	GET	`/linear-swap-ex/market/depth`	`htx-cli futures call GET /linear-swap-ex/market/depth --json`	Order book depth
2	GET	`/linear-swap-ex/market/bbo`	`htx-cli futures call GET /linear-swap-ex/market/bbo --json`	Best bid / offer
3	GET	`/linear-swap-ex/market/history/kline`	`htx-cli futures call GET /linear-swap-ex/market/history/kline --json`	K-line
4	GET	`/linear-swap-ex/market/history/mark_price_kline`	`htx-cli futures call GET /linear-swap-ex/market/history/mark_price_kline --json`	Mark-price kline
5	GET	`/linear-swap-ex/market/detail/merged`	`htx-cli futures call GET /linear-swap-ex/market/detail/merged --json`	Single-contract overview
6	GET	`/linear-swap-ex/market/detail/batch_merged`	`htx-cli futures market tickers --json`	All-contracts overview
7	GET	`/linear-swap-ex/market/trade`	`htx-cli futures call GET /linear-swap-ex/market/trade --json`	Latest trade
8	GET	`/linear-swap-ex/market/history/trade`	`htx-cli futures call GET /linear-swap-ex/market/history/trade --json`	Recent trades
9	GET	`/linear-swap-ex/market/his_open_interest`	`htx-cli futures call GET /linear-swap-ex/market/his_open_interest --json`	Historical OI
10	GET	`/linear-swap-ex/market/history/premium_index_kline`	`htx-cli futures call GET /linear-swap-ex/market/history/premium_index_kline --json`	Premium index kline
11	GET	`/linear-swap-ex/market/history/estimated_rate_kline`	`htx-cli futures call GET /linear-swap-ex/market/history/estimated_rate_kline --json`	Estimated funding rate kline

Reference data — requires read permission (6)


htx-cli futures account unified-type --json
htx-cli futures call POST /linear-swap-api/v1/swap_cross_tiered_margin_info --json
htx-cli futures call POST /linear-swap-api/v1/swap_tiered_margin_info --json
htx-cli futures call POST /linear-swap-api/v1/swap_adjustment_factor --json
htx-cli futures call POST /linear-swap-api/v1/swap_cross_adjustment_factor --json
htx-cli futures call POST /linear-swap-api/v3/swap_switch_account_type --body '{"account_type":1}' --json

#	Method	Endpoint	CLI invocation	Description
1	GET	`/linear-swap-api/v3/swap_unified_account_type`	`htx-cli futures account unified-type --json`	Unified account type
2	POST	`/linear-swap-api/v1/swap_cross_tiered_margin_info`	`htx-cli futures call POST /linear-swap-api/v1/swap_cross_tiered_margin_info --json`	Cross tier margin
3	POST	`/linear-swap-api/v1/swap_tiered_margin_info`	`htx-cli futures call POST /linear-swap-api/v1/swap_tiered_margin_info --json`	Isolated tier margin
4	POST	`/linear-swap-api/v1/swap_adjustment_factor`	`htx-cli futures call POST /linear-swap-api/v1/swap_adjustment_factor --json`	Isolated adjustment factor
5	POST	`/linear-swap-api/v1/swap_cross_adjustment_factor`	`htx-cli futures call POST /linear-swap-api/v1/swap_cross_adjustment_factor --json`	Cross adjustment factor
6	POST	`/linear-swap-api/v3/swap_switch_account_type`	`htx-cli futures call POST /linear-swap-api/v3/swap_switch_account_type --body '{"account_type":1}' --json`	Switch account type (write, keep in market skill per plan)

Endpoint #6 is a write but the HTX plan groups it with reference-data configuration. Agent should still display the target account type to the user before calling it.

Contract code format

USDT-M perpetual codes are

<BASE>-USDT

:

BTC-USDT, ETH-USDT, SOL-USDT, ...

Not all endpoints accept a

contract_code

filter — some return the whole universe.

Typical queries

"BTC funding rate?" →

htx-cli futures market funding-rate BTC-USDT --json

"ETH 1-hour futures klines" →

htx-cli futures call GET /linear-swap-ex/market/history/kline --query contract_code=ETH-USDT&period=60min&size=200 --json

"Total liquidations today for BTC" →

htx-cli futures market liquidation-orders --contract-code BTC-USDT --json

"Top traders long/short ratio" →

htx-cli futures call GET /linear-swap-api/v1/swap_elite_position_ratio --query contract_code=BTC-USDT --json

References

```
references/contract-info.md
```
— contract code & tier margin quick reference
```
references/funding-rate.md
```
— funding mechanics