spot

HTX Spot スキル

認証済み API エンドポイントを使用した HTX の現物取引。一部のエンドポイントでは API キーとシークレットキーが必要です。結果は JSON 形式で返します。

クイックリファレンス

参照データエンドポイント

エンドポイント	説明	必須	任意	認証
GET /v2/market-status	1=通常、2=停止、3=キャンセルのみなどの列挙値を含む、現在の市場ステータスを返します	なし	なし	なし
GET /v2/settings/common/symbols	ステータス、精度、取引状況などの詳細な設定を含む、サポート対象のすべての取引シンボルを返します	なし	ts	なし
GET /v2/settings/common/currencies	設定と表示名を含む、サポート対象のすべての通貨を返します	なし	ts	なし
GET /v1/settings/common/symbols	価格と取引の精度情報を含むシンボル設定を返します	なし	なし	なし
GET /v1/settings/common/market-symbols	現物取引の市場シンボル設定を返します	なし	なし	なし
GET /v2/reference/currencies	通貨およびブロックチェーンのチェーン参照データを返します	なし	なし	なし
GET /v1/common/timestamp	現在のサーバータイムスタンプをミリ秒単位で返します	なし	なし	なし

市場データエンドポイント

エンドポイント	説明	必須	任意	認証
GET /market/history/klines	指定したシンボルと時間間隔の OHLC ローソク足データを返します	symbol, period	size, from	なし
GET /market/detail	価格、出来高、24 時間統計を含む、シンボルの最新市場ティッカーデータを返します	symbol	なし	なし
GET /market/tickers	すべての取引ペアの最新ティッカーデータを返します	なし	なし	なし
GET /market/depth	シンボルの注文板の深さ（買い注文と売り注文）を返します	symbol, type	なし	なし
GET /market/trade	シンボルの最新取引データを返します	symbol	なし	なし
GET /market/history/trade	シンボルの最近の取引データを返します	symbol	size	なし
GET /market/overview	すべてのシンボルの 24 時間市場サマリー統計を返します	なし	なし	なし
GET /market/orderbook	シンボルの完全な深度を含む注文板全体を返します	symbol	depth	なし

アカウントエンドポイント

エンドポイント	説明	必須	任意	認証
GET /v1/account/accounts	認証済みユーザーのすべてのアカウント詳細を返します	なし	なし	はい
GET /v1/account/accounts/{account-id}/balance	資産と負債を含む、特定のアカウントの残高詳細を返します	account-id	なし	はい
GET /v2/account/valuation	ユーザーのポートフォリオ内の全アカウントの総資産評価額を返します	なし	valuationCurrency	はい
GET /v2/account/asset-valuation	詳細な資産評価額とポートフォリオ構成を返します	なし	なし	はい
POST /v1/account/transfer	アカウント間で資産を移転します	from-account, to-account, currency, amount	なし	はい
GET /v1/account/history	アカウント履歴と取引記録を返します	なし	account-id, currency, type	はい
POST /v1/futures/transfer	現物取引アカウントと先物契約アカウント間で資金を移転します	currency, amount, type	なし	はい
GET /v1/point/account	現在の HTX ポイント残高と履歴を返します	なし	なし	はい
POST /v1/point/transfer	アカウント間で HTX ポイントを移転します	from-user, to-user, amount	なし	はい

取引エンドポイント

エンドポイント	説明	必須	任意	認証
POST /v1/order/orders/place	新しい現物取引注文（指値または成行）を発注します	account-id, amount, symbol, type	price, client-order-id, source, time-in-force	はい
POST /v1/order/orders/{order-id}/cancel	保留中の注文をキャンセルします	order-id	なし	はい
POST /v1/order/orders/batchcancel	指定した条件に一致する複数の注文をキャンセルします	なし	account-id, symbol	はい
GET /v1/order/orders/{order-id}	特定の注文の詳細を返します	order-id	なし	はい
GET /v1/order/orders	指定した条件（オープン、クローズ、キャンセル済み）に一致する注文を返します	account-id	symbol, states, types, start-time, end-time, from, direct, size	はい
GET /v1/order/orders/getClientOrder	client-order-id を使用して注文の詳細を返します	client-order-id	なし	はい
GET /v1/order/matchresults	取引履歴と約定の詳細を返します	なし	symbol, types, start-time, end-time, from, direct, size	はい

証拠金ローン（クロス／分離）エンドポイント

エンドポイント	説明	必須	任意	認証
POST /v1/margin/orders	クロスまたは分離証拠金口座で証拠金ローンを申し込みます	currency, amount	account-id	はい
POST /v1/margin/orders/{order-id}/repay	利息を含めて証拠金ローンを返済します	order-id, amount	なし	はい
GET /v1/margin/orders	証拠金ローンの注文とそのステータスを返します	なし	currency, state, from, size	はい
GET /v1/margin/accounts/balance	証拠金口座の詳細な残高情報を返します	なし	account-id	はい

---

パラメーター

共通パラメーター

• symbol：取引シンボル（例：btcusdt、ethusdt）
• symbols：カンマ区切りのシンボル一覧
• account-id：口座 ID（/v1/account/accounts から取得できます）
• type：注文タイプ
• amount：注文数量（成行買い注文の場合、数量は決済通貨建てです。それ以外の場合は基軸通貨建てです）
• price：注文価格（指値注文で必須）
• source：注文元（デフォルト：spot-api）
• client-order-id：クライアントが定義する注文 ID（最大長：64）
• self-match-prevent：セルフマッチ防止（0=無効、1=有効）
• stop-price：ストップリミット注文のストップ価格
• operator：ストップ注文の演算子（gte、lte）
• order-id：注文 ID
• period：Kline の期間／インターバル
• size：返すレコード数
• depth：深度レベル（例：step0、step1、step2 など）
• side：注文サイド（buy、sell）
• states：注文ステータス（カンマ区切り）
• types：注文タイプ（カンマ区切り）
• start-date：開始日（形式：yyyy-mm-dd）
• end-date：終了日（形式：yyyy-mm-dd）
• start-time：開始時刻（ミリ秒単位の Unix タイムスタンプ）
• end-time：終了時刻（ミリ秒単位の Unix タイムスタンプ）
• from：ページネーションの開始 ID
• direct：ページネーションの方向（prev、next）
• accountType：資産評価の口座タイプ
• valuationCurrency：評価に使用する通貨（例：BTC、USDT、CNY）
• transactTypes：取引タイプ（カンマ区切り）
• limit：返すレコード数
• fromId：クエリの開始 ID
• currency：通貨名（小文字、例：btc、usdt）
• show-desc：説明を表示するかどうか（true、false）
• ts：クエリ用タイムスタンプ（任意）
• authorizedUser：認証済みユーザーフラグ（true、false）

列挙型

• period：1min | 5min | 15min | 30min | 60min | 4hour | 1day | 1mon | 1week | 1year
• type (order)：buy-market | sell-market | buy-limit | sell-limit | buy-ioc | sell-ioc | buy-limit-maker | sell-limit-maker | buy-stop-limit | sell-stop-limit | buy-limit-fok | sell-limit-fok | buy-stop-limit-fok | sell-stop-limit-fok
• side：buy | sell
• states：submitted | partial-filled | partial-canceled | filled | canceled
• operator：gte | lte
• accountType：spot | margin | otc | point | super-margin | investment | borrow
• transactTypes：trade | etf | transact-fee | deduction | transfer | credit | liquidation | interest | deposit-withdraw | withdraw-fee | exchange | other-types
• depth (step)：step0 | step1 | step2 | step3 | step4 | step5

---

認証

認証が必要なエンドポイントでは、HTX API の認証情報を指定する必要があります。 必要な認証情報：

• apiKey：HTX API キー（AccessKeyId パラメーター用）
• secretKey：HTX API シークレット（署名用）

ベース URL：

• メインネット：https://api.huobi.pro
• メインネット（AWS）：https://api-aws.huobi.pro

セキュリティ

認証情報の共有

ユーザーは、次の形式の内容を含むファイルを送信して、HTX API の認証情報を提供できます。

fe45419a...xyz
secretabc...key

シークレット全体を表示しない

ユーザーに認証情報を表示するとき：

• API キー： 先頭 5 文字と末尾 4 文字を表示します：fe45419a...xyz
• シークレットキー： 必ずマスクし、末尾 5 文字のみを表示します：***...key1

認証情報を尋ねられた場合の応答例：

Account: main
API Key: fe45419a...xyz
Secret: ***...key1
Environment: Mainnet

アカウントの一覧表示

アカウントを一覧表示するときは、名前と環境のみを表示し、キーは表示しないでください。

HTX Accounts:
* main (Mainnet)
* trading (Mainnet - AWS)

メインネットでの取引

メインネットで取引を実行する場合は、続行する前に「CONFIRM」と入力するようユーザーに尋ね、必ず確認を取ってください。

---

HTX アカウント

main

• API キー：your_mainnet_api_key
• シークレット：your_mainnet_secret
• 環境：https://api.huobi.pro
• 説明：メインの取引アカウント

trading

• API キー：your_aws_api_key
• シークレット：your_aws_secret
• 環境：https://api-aws.huobi.pro
• 説明：AWS に最適化された取引

TOOLS.md の構造

## HTX Accounts

### main
- API Key: fe45419a...xyz
- Secret: secretabc...key
- Environment: https://api.huobi.pro
- Description: Primary trading account

### trading
- API Key: test456...abc
- Secret: testsecret...xyz
- Environment: https://api-aws.huobi.pro
- Description: AWS optimized trading

エージェントの動作

1. 認証情報を求められた場合：シークレットをマスクし、末尾 5 文字のみを表示します
2. アカウントを一覧表示する場合：名前と環境を表示し、キーは表示しません
3. アカウントの選択：あいまいな場合は尋ね、デフォルトは main にします
4. メインネットで取引を行う場合は、続行前に「CONFIRM」と入力するようユーザーに尋ねて確認します
5. 新しい認証情報：名前と環境を尋ねます

アカウントの追加

ユーザーが新しい認証情報を提供した場合：

• アカウント名を尋ねます
• 環境（Mainnet または Mainnet-AWS）を尋ねます
• マスクした状態での表示を確認してから、TOOLS.md に保存します

リクエストの署名

認証が必要なすべてのエンドポイントでは、HMAC SHA256 署名が必要です。

1. 次の順序で署名前文字列を作成します：
   • HTTP メソッド（GET/POST）+ "\n"
   • API ホスト（例：api.huobi.pro）+ "\n"
   • API パス（例：/v1/order/orders）+ "\n"
   • ソート済みクエリ文字列パラメーター
2. 認証が必要なすべてのリクエストに必須パラメーターを追加します：
   • AccessKeyId：API キー
   • SignatureMethod：HmacSHA256
   • SignatureVersion：2
   • Timestamp：yyyy-MM-ddTHH:mm:ss 形式の UTC タイムスタンプ
3. secretKey を使用して、HMAC SHA256 で署名前文字列に署名します
4. Signature パラメーターとして署名をクエリ文字列に追加します
5. POST リクエストの場合は、URL のクエリ文字列にも署名を含めます

署名前文字列の例：

POST\n
api.huobi.pro\n
/v1/order/orders/place\n
AccessKeyId=xxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15:19:30

User Agent ヘッダー

次の文字列を含む User-Agent ヘッダーを指定します：htx-spot/1.0.0 (Skill)

重要な注意事項

• すべてのタイムスタンプは Unix ミリ秒単位です
• シンボル名は小文字にしてください（例：BTCUSDT ではなく btcusdt）
• 成行買い注文の場合、amount パラメーターはクオート通貨の金額を表します
• それ以外のすべての注文タイプでは、amount はベース通貨の金額を表します
• 取引を行う前に、/v1/account/accounts エンドポイントからアカウント ID を取得する必要があります
• レート制限が適用されます。詳細は HTX API ドキュメントを参照してください
• 認証が必要なリクエストごとに署名を計算する必要があります
• 署名のタイムスタンプはサーバー時刻との差が 1 分以内である必要があります
• 注文の照会では、API 経由で作成した注文は、キャンセルされてから 2 時間を超えると照会できなくなります
• 過去データの照会期間は通常、最大 48 時間で、過去 180 日分のデータを利用できます
• 一括注文を行う場合、1 バッチあたり最大 10 件の注文を指定できます
• 手数料率の照会では、一度に最大 10 件の取引ペアを指定できます
• すべてのリクエストエンドポイントは、ドキュメントに記載されたエンドポイントと一致している必要があります。

API ドキュメント

詳細については、HTX の公式 API ドキュメントを参照してください：https://www.htx.com/en-us/opend/newApiPages/