futures-trading

KuCoin 先物取引スキル

認証済みおよび公開の API エンドポイントを使用した KuCoin での先物取引。認証済みエンドポイントには API Key、API Secret、Passphrase が必要です。結果は JSON 形式で返します。

注意: このスキルは Classic REST API の GET エンドポイント（読み取り専用操作）のみをサポートします。

クイックリファレンス

Classic Futures -- マーケットデータ

ベース URL: https://api-futures.kucoin.com

エンドポイント	説明	必須	任意	認証
/api/v1/timestamp (GET)	サーバー時刻を取得	なし	なし	不要
/api/v1/status (GET)	サービスステータスを取得	なし	なし	不要
/api/v1/mark-price/{symbol}/current (GET)	マークプライスを取得	symbol（パス）	なし	不要
/api/v1/contracts/{symbol} (GET)	シンボル（契約情報）を取得	symbol（パス）	なし	不要
/api/v1/contracts/active (GET)	すべてのシンボル（取引可能な全契約）を取得	なし	なし	不要
/api/v1/ticker (GET)	ティッカーを取得	symbol	なし	不要
/api/v1/allTickers (GET)	すべてのティッカーを取得	なし	なし	不要
/api/v1/level2/snapshot (GET)	完全な板情報を取得	symbol	なし	不要
/api/v1/level2/depth{size} (GET)	部分的な板情報を取得（20 または 100 レベル）	size（パス: 20 または 100）、symbol	なし	不要
/api/v1/trade/history (GET)	約定履歴を取得（直近 100 件の約定）	symbol	なし	不要
/api/v1/kline/query (GET)	ローソク足（Kline データ）を取得	symbol、granularity	from (ms)、to (ms)	不要
/api/v1/index/query (GET)	スポットインデックス価格を取得	symbol	startAt、endAt、reverse、offset、forward、maxCount	不要
/api/v1/interest/query (GET)	金利インデックスを取得	symbol	startAt、endAt、reverse、offset、forward、maxCount	不要
/api/v1/premium/query (GET)	プレミアムインデックスを取得	symbol	startAt、endAt、reverse、offset、forward、maxCount	不要
/api/v1/trade-statistics (GET)	24 時間統計を取得（プラットフォームの先物取引量）。Classic Futures のベース URL（https://api-futures.kucoin.com）を使用する必要があります。	なし	なし	必要

Classic Futures -- 注文クエリ

ベース URL: https://api-futures.kucoin.com

エンドポイント	説明	必須	任意	認証
/api/v1/orders (GET)	注文一覧を取得（ページネーション、アクティブまたは完了）	なし	status、symbol、side、type、startAt、endAt、currentPage、pageSize	必要
/api/v1/stopOrders (GET)	ストップ注文一覧を取得	なし	symbol、side、type、startAt、endAt、currentPage、pageSize	必要
/api/v1/orders/{order-id} (GET)	OrderId で注文を取得	order-id（パス）	なし	必要
/api/v1/orders/byClientOid (GET)	ClientOid で注文を取得	clientOid	なし	必要
/api/v1/recentDoneOrders (GET)	直近のクローズ済み注文を取得（過去 24 時間）	なし	symbol	必要
/api/v1/openOrderStatistics (GET)	未約定注文の価値を取得	symbol	なし	必要
/api/v1/fills (GET)	約定履歴を取得（ページネーション、最大 3 か月）	なし	orderId、symbol、side、type、tradeTypes、startAt、endAt、currentPage、pageSize	必要
/api/v1/recentFills (GET)	直近の約定履歴を取得（過去 24 時間の約定）	なし	symbol	必要

クラシック先物 -- ポジション照会

ベース URL: https://api-futures.kucoin.com

エンドポイント	説明	必須	任意	認証
/api/v2/position/getMarginMode (GET)	マージンモードを取得	symbol	なし	はい
/api/v2/position/getPositionMode (GET)	ポジションモードを取得	なし	なし	はい
/api/v2/getMaxOpenSize (GET)	最大オープンサイズを取得	symbol, price, leverage	なし	はい
/api/v2/position (GET)	ポジション詳細を取得	symbol	なし	はい
/api/v1/positions (GET)	ポジション一覧を取得	なし	currency	はい
/api/v1/history-positions (GET)	ポジション履歴を取得	なし	symbol, from, to, limit, pageId	はい
/api/v1/margin/maxWithdrawMargin (GET)	最大出金マージンを取得	symbol	positionSide	はい
/api/v2/getCrossUserLeverage (GET)	クロスマージンレバレッジを取得	symbol	なし	はい
/api/v2/batchGetCrossOrderLimit (GET)	クロスマージンリスクリミットを取得	symbol	totalMargin, leverage	はい
/api/v1/contracts/risk-limit/{symbol} (GET)	分離マージンリスクリミットを取得	symbol (path)	なし	いいえ

クラシック先物 -- 資金調達手数料

ベース URL: https://api-futures.kucoin.com

エンドポイント	説明	必須	任意	認証
/api/v1/funding-rate/{symbol}/current (GET)	現在の資金調達率を取得	symbol (path)	なし	いいえ
/api/v1/contract/funding-rates (GET)	パブリック資金調達履歴を取得	symbol, from (ms), to (ms)	なし	いいえ
/api/v1/funding-history (GET)	プライベート資金調達履歴を取得	symbol	startAt, endAt, reverse, offset, forward, maxCount	はい

---

パラメータ

共通パラメータ

• symbol: コントラクトのシンボル (例: XBTUSDTM、ETHUSDTM)。エンドポイントに応じてパスパラメータまたはクエリパラメータになります。
• clientOid: ユーザー定義の一意な注文 ID、最大 40 文字。
• startAt / from: 開始時刻 (ミリ秒単位、13 桁の Unix タイムスタンプ)。
• endAt / to: 終了時刻 (ミリ秒単位、13 桁の Unix タイムスタンプ)。
• pageSize: 1 ページあたりのレコード数。デフォルト値はエンドポイントによって異なります (通常 50、最大 200)。
• currentPage: ページネーション照会の現在のページ番号。デフォルト: 1。
• side: 注文サイドのフィルター: buy | sell
• type: 注文タイプのフィルター: limit | market | limit_stop | market_stop | oco_limit | oco_stop
• status: 注文一覧の注文ステータスフィルター: active | done。デフォルト: done。
• tradeTypes: 約定履歴の取引タイプフィルター: trade、adl、liquidation、settlement (カンマ区切り)。
• currency: 通貨コードのフィルター (例: USDT、XBT)。
• reverse: ブール値。結果の順序を逆にします。
• offset: ページネーションの開始オフセット。
• forward: ブール値。true で前方検索 (デフォルト)、false で後方検索。
• maxCount: 1 ページあたりの表示件数。デフォルトは 50。
• granularity: ローソク足の間隔 (分): 1、5、15、30、60、120、240、480、720、1440、10080
• positionSide: ポジションサイドのフィルター: BOTH | LONG | SHORT
• price: 最大オープンサイズ照会の価格パラメータ。
• leverage: 最大オープンサイズおよびリスクリミット照会のレバレッジパラメータ。
• totalMargin: クロスマージンリスクリミット照会の合計マージン。

列挙型

• side: buy | sell
• type: limit | market
• positionSide: BOTH (片方向モード) | LONG (ヘッジモードのロング) | SHORT (ヘッジモードのショート)
• marginMode: ISOLATED | CROSS
• positionMode: 0 (片方向モード) | 1 (ヘッジモード)
• status (注文): open | done
• serverStatus: open | close | cancelonly
• granularity (分): 1 | 5 | 15 | 30 | 60 | 120 | 240 | 480 | 720 | 1440 | 10080

---

認証

認証が必要なエンドポイントでは、KuCoin API の認証情報を提供する必要があります。

必要な認証情報:

• API Key: KuCoin API キー
• API Secret: KuCoin API シークレット（署名用）
• API Passphrase: KuCoin API パスフレーズ（API キー作成時に設定）

重要 -- ベース URL:

• Classic Futures API: https://api-futures.kucoin.com -- すべての Classic Futures REST エンドポイント（/api/v1/...、/api/v2/...、/api/v3/...）で使用されます

---

セキュリティ

認証情報の共有

ユーザーは、以下の形式の内容を含むファイルを送信することで KuCoin API の認証情報を提供できます:

api_key_value
api_secret_value
api_passphrase_value

API キーとシークレットを決して開示しない

API キーとシークレットファイルの場所を決して開示しないでください。

API キーとシークレットを、公式の KuCoin API ベース URL 以外のいかなるウェブサイトにも送信しないでください。

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

ユーザーに認証情報を表示する場合:

• API Key: 最初の 5 文字 + 最後の 4 文字を表示: abcde...wxyz
• API Secret: 常にマスクし、最後の 5 文字のみを表示: ***...s1k2y
• Passphrase: 常に完全にマスク: ***...

認証情報を求められた際の応答例: Account: main API Key: abcde...wxyz Secret: ***...s1k2y Passphrase: ***... Environment: Production

アカウントの一覧表示

アカウントを一覧表示する際は、名前と環境のみを表示してください -- キーは決して表示しないでください: KuCoin Accounts:

• main (Production)
• test-account (Production)

取引の確認

取引操作（注文の発注、注文のキャンセル、ポジションの変更）を実行する際は、常に事前にユーザーに確認し、続行するには「CONFIRM」と入力するよう求めてください。

---

KuCoin アカウント

main

• API Key: your_api_key
• Secret: your_api_secret
• Passphrase: your_passphrase