mcpField
M
margin-trading

margin-trading

github.com/kucoinその他2881 回インストール32 週間前に更新
リポジトリ

margin-trading について

KuCoinのマージン取引を読み取り専用で照会するスキルです。Classic REST APIのGETエンドポイントを使い、クロスマージンと分離マージンの市場データ、注文、借入・貸付、リスク上限を確認できます。認証付き照会にはKuCoin APIの認証情報が必要です。

主な機能

  1. 01クロス・分離マージン市場データの照会
  2. 02有効・完了注文の照会
  3. 03ストップ注文とOCO注文の確認
  4. 04借入・返済・利息履歴の確認
  5. 05貸付とリスク上限データの照会

活用シーン

  1. 01マージン取引ペアの価格と担保率の確認
  2. 02注文・約定履歴の確認
  3. 03借入、返済、利息の追跡
  4. 04貸付注文と通貨別リスク上限の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/kucoin/kucoin-skills-hub --skill margin-trading

インストール後、Claude Code で/margin-tradingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
LICENSE.md
references/
authentication.md

詳細

KuCoin マージン取引スキル

認証済み API エンドポイントを使用した KuCoin でのマージン取引。クロスマージンおよび分離マージンの市場データ、HF 注文クエリ、ストップ注文クエリ、OCO 注文クエリ、借入・返済履歴クエリ、レンディングクエリ、リスク制限をサポートします。認証済みエンドポイントには API Key、API Secret、Passphrase が必要です。結果は JSON 形式で返します。

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

クイックリファレンス

Classic マージン市場データ
エンドポイント説明必須任意認証
/api/v3/margin/symbols (GET)シンボルの取得 - クロスマージン（取引ペア設定）なしsymbolいいえ
/api/v1/isolated/symbols (GET)シンボルの取得 - 分離マージン（取引ペア設定）なしなしいいえ
/api/v3/etf/info (GET)ETF 情報の取得（レバレッジトークン情報）なしcurrencyいいえ
/api/v1/mark-price/{symbol}/current (GET)マーク価格詳細の取得（マージンペアの現在のマーク価格）symbol（パス）なしいいえ
/api/v1/margin/config (GET)マージン設定の取得（クロスマージン設定、通貨リスト）なしなしいいえ
/api/v3/mark-price/all-symbols (GET)マーク価格リストの取得（すべてのマージンペアの現在のマーク価格）なしなしいいえ
/api/v3/margin/collateralRatio (GET)マージン担保比率の取得なしcurrencyListいいえ
/api/v3/margin/available-inventory (GET)市場で利用可能なインベントリの取得（プラットフォームの借入可能額）なしcurrencyいいえ
Classic マージン HF 注文クエリ
エンドポイント説明必須任意認証
/api/v3/hf/margin/orders/{orderId} (GET)OrderId による注文の取得orderId（パス）、symbol（クエリ）なしはい
/api/v3/hf/margin/orders/client-order/{clientOid} (GET)ClientOid による注文の取得clientOid（パス）、symbol（クエリ）なしはい
/api/v3/hf/margin/order/active/symbols (GET)未約定注文があるシンボルの取得tradeTypeなしはい
/api/v3/hf/margin/orders/active (GET)未約定注文の取得symbol、tradeTypeなしはい
/api/v3/hf/margin/orders/done (GET)約定済み注文の取得symbol、tradeTypeside、type、lastId、limit、startAt、endAtはい
/api/v3/hf/margin/fills (GET)取引履歴の取得symbol、tradeTypeorderId、side、type、lastId、limit、startAt、endAtはい
Classic マージンストップ注文クエリ
エンドポイント説明必須任意認証
/api/v3/hf/margin/stop-orders (GET)ストップ注文リストの取得（ページネーション、未トリガー）なしsymbol、side、type、tradeType、startAt、endAt、currentPage、orderIds、pageSize、stopはい
/api/v3/hf/margin/stop-order/orderId (GET)OrderId によるストップ注文の取得orderIdなしはい
/api/v3/hf/margin/stop-order/clientOid (GET)ClientOid によるストップ注文の取得clientOidなしはい
Classic マージン OCO 注文クエリ
エンドポイント説明必須任意認証
/api/v3/hf/margin/oco-order/orderId (GET)OrderId による OCO 注文の取得orderIdなしはい
/api/v3/hf/margin/oco-order/clientOid (GET)ClientOid による OCO 注文の取得clientOidなしはい
/api/v3/hf/margin/oco-order/detail/orderId (GET)OrderId による OCO 注文詳細の取得（サブ注文を含む）orderIdなしはい
/api/v3/hf/margin/oco-orders (GET)OCO 注文リストの取得（ページネーション）pageSize、currentPagesymbol、startAt、endAt、orderIds、tradeTypeはい
クラシック借入クエリ (借入と返済)
エンドポイント説明必須任意認証
/api/v3/margin/borrowRate (GET)借入金利を取得なしvipLevel, currencyはい
/api/v3/margin/borrow (GET)借入履歴を取得currencyisIsolated, symbol, orderNo, startTime, endTime, currentPage, pageSizeはい
/api/v3/margin/repay (GET)返済履歴を取得currencyisIsolated, symbol, orderNo, startTime, endTime, currentPage, pageSizeはい
/api/v3/margin/interest (GET)利息履歴を取得なしcurrency, isIsolated, symbol, startTime, endTime, currentPage, pageSizeはい
クラシック融資クエリ (貸付)
エンドポイント説明必須任意認証
/api/v3/project/list (GET)融資マーケットを取得 (貸付可能な通貨)なしcurrencyはい
/api/v3/project/marketInterestRate (GET)融資マーケット金利を取得 (過去 7 日間)currencyなしはい
/api/v3/purchase/orders (GET)購入注文を取得 (ページネーション)statuscurrency, purchaseOrderNo, currentPage, pageSizeはい
/api/v3/redeem/orders (GET)償還注文を取得 (ページネーション)statuscurrency, redeemOrderNo, currentPage, pageSizeはい
クラシックリスクリミット
エンドポイント説明必須任意認証
/api/v3/margin/currencies (GET)マージンリスクリミットを取得 (通貨/シンボルごとの設定とリスクリミット情報)なしisIsolated, currency, symbolはい

パラメータ

共通パラメータ
  • clientOid: クライアント注文 ID。ユーザーが作成する一意の識別子 (UUID を推奨)。最大長: 40 文字。
  • symbol: 取引ペアのシンボル (例: BTC-USDT)
  • side: 注文サイドのフィルター: buy | sell
  • type: 注文タイプのフィルター: limit | market
  • orderId: 照会する注文 ID
  • isIsolated: true の場合は分離マージン、false の場合はクロスマージン。デフォルトは false です。
  • tradeType: 取引タイプ: MARGIN_TRADE (クロスマージン)、MARGIN_ISOLATED_TRADE (分離マージン)
  • stop: ストップ注文のトリガー条件フィルター: loss | entry
  • lastId: 前のバッチの最後のデータセットの ID。カーソルベースのページネーションに使用します。
  • limit: 1 ページあたりの結果数。デフォルト: 20、最大: 100 (注文/約定の照会の場合)。
  • currentPage: ページネーション照会の現在のページ番号。デフォルト: 1。
  • pageSize: ページネーション照会のページサイズ。エンドポイントによって異なります (一般的なデフォルト: 50、最大: 500)。
  • startAt / startTime: ミリ秒単位の開始時刻フィルター。
  • endAt / endTime: ミリ秒単位の終了時刻フィルター。
  • currency: 通貨コード (例: BTC、USDT)。
  • vipLevel: VIP レベル。空の場合、現在のユーザーの VIP レベルがデフォルトになります。
  • orderNo: 借入/返済履歴照会の注文番号。
  • purchaseOrderNo: 貸付操作の購入注文 ID。
  • redeemOrderNo: 償還照会の償還注文 ID。
  • status: 注文ステータスのフィルター。値はエンドポイントによって異なります (例: DONE、PENDING)。
  • currencyList: 担保比率照会のためのカンマ区切りの通貨リスト。
列挙型
  • side: buy | sell
  • type: limit | market
  • tradeType: MARGIN_TRADE (クロスマージン) | MARGIN_ISOLATED_TRADE (分離マージン)
  • stop: loss | entry
  • purchase/redeem status: DONE | PENDING
  • OCO order status: NEW | DONE | TRIGGERED | CANCELLED
  • stop order status: NEW | TRIGGERED
  • liquidity: taker | maker

認証

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

  • API Key: KuCoin API キー（ヘッダー KC-API-KEY 用）
  • API Secret: KuCoin API シークレット（署名用）
  • Passphrase: KuCoin API パスフレーズ（ヘッダー KC-API-PASSPHRASE 用）

ベース URL:

  • 本番環境: https://api.kucoin.com

セキュリティ

認証情報の共有

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

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

API キー、シークレット、またはパスフレーズのファイルの場所を決して開示しないでください。

API キー、シークレット、またはパスフレーズを、公式の KuCoin API エンドポイント以外のいかなるウェブサイトにも送信しないでください。

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

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

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

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

アカウントの一覧表示

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

  • main (Production)
  • margin-keys (Production)
本番環境でのトランザクション

本番環境でトランザクションを実行する場合は、続行する前に必ずユーザーに「CONFIRM」と入力して続行するよう求めて確認してください。

KuCoin アカウント

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

コメント

Markdown 対応