Skip to main content

​
HTX (Huobi) Exchange Setup

HTX (formerly Huobi) is a major cryptocurrency exchange supporting perpetual futures trading. This guide covers API setup and configuration.

​
Prerequisites

1

Create HTX Account

If you don’t have an account, register at htx.com
2

Complete KYC

Identity verification is required for derivatives trading
3

Enable Futures Trading

Navigate to Derivatives → USDT-M Futures and enable trading
4

Fund Your Account

Transfer USDT to your USDT-M Futures wallet

​
Creating API Keys

​
Step 1: Access API Management

  1. Log in to HTX
  2. Click your profile icon (top right)
  3. Select API Management
  4. Click Create API Key

​
Step 2: Configure Permissions

Security First: Only enable the permissions you need.For Quant Dash, you need:
  • Read - Always required
  • Trade - Required for placing orders
  • DO NOT enable Withdraw - Never needed, keeps funds secure
Select these permissions:
  • Read Info
  • Trade
  • Withdraw ← Leave unchecked!
For maximum security, restrict API access to specific IPs:
  1. Select Bind IP addresses
  2. Add your server’s IP address
  3. This prevents unauthorized access even if keys are leaked

​
Step 4: Save Your Credentials

You will receive:
  • API Key (Access Key)
  • Secret Key
Save both immediately - the Secret Key is only shown once!

​
Adding HTX to Quant Dash

​
Via Dashboard

  1. Navigate to Settings → Exchanges
  2. Click Add Exchange
  3. Select HTX from the dropdown
  4. Enter your credentials:
    • API Key: Your Access Key
    • API Secret: Your Secret Key
  5. Click Test Connection
  6. If successful, click Save

​
Configuration Example

{
  "exchange": {
    "name": "htx",
    "api_key": "your-api-key",
    "api_secret": "your-secret-key",
    "testnet": false
  }
}

​
HTX-Specific Settings

​
Supported Features

FeatureSupportedNotes
USDT-M PerpetualsYesPrimary market
Hedge ModeYesLong + Short simultaneously
Cross MarginYesDefault mode
Isolated MarginYesPer-position margin
Maximum Leverage125xVaries by symbol

​
Symbol Format

HTX uses standard symbol format:
  • Dashboard: BTCUSDT
  • API: BTC-USDT
The bot handles conversion automatically.

​
Rate Limits

HTX has strict rate limits:
  • 10 requests per second for order placement
  • 20 requests per second for market data
The bot includes built-in rate limiting to stay within these bounds.

​
Transferring Funds

​
To Futures Wallet

  1. Go to Assets → Transfer
  2. From: Spot Account
  3. To: USDT-M Futures
  4. Enter amount and confirm
Funds must be in the USDT-M Futures wallet before the bot can trade.

​
Checking Balance

Your futures balance shows:
  • Available Balance: Can be used for new positions
  • Used Margin: Locked for open positions
  • Unrealized PnL: Current position profit/loss

​
Troubleshooting

​
”Invalid API Key”

  1. Verify you copied the full key (no spaces)
  2. Check if key is expired or deleted
  3. Ensure you’re using the correct account (main vs sub-account)

​
“Insufficient Balance”

  1. Check funds are in USDT-M Futures wallet (not Spot)
  2. Verify available margin after existing positions
  3. Reduce position size or close existing trades

​
”Order Rejected”

  1. Check symbol is correct and tradeable
  2. Verify leverage settings match exchange limits
  3. Ensure order size meets minimum requirements

​
”Rate Limit Exceeded”

  1. Reduce number of simultaneous bots
  2. Increase quote refresh interval
  3. Reduce geometric sizing levels

​
Security Best Practices

No Withdraw Permission

Never enable withdraw - keeps funds secure even if keys leak

IP Restriction

Bind API to specific IPs for maximum security

Regular Rotation

Rotate API keys every 90 days

Monitor Activity

Check API logs regularly for unusual activity

​
Next Steps

Configure Bot

Set up your trading bot

Choose Strategy

Select a trading strategy