mcpField
C
convert

convert

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

convert について

KuCoin の通貨変換ペア、見積もり、注文詳細を照会する Claude Skill です。読み取り専用の Classic REST GET エンドポイントを使い、結果を JSON で返します。

主な機能

  1. 01対応する変換ペアと通貨の照会
  2. 02成行・指値の見積もり取得
  3. 03変換注文の詳細確認
  4. 04成行・指値注文履歴の一覧

活用シーン

  1. 01変換前の対応通貨の確認
  2. 02通貨ペアの見積もり確認
  3. 03変換注文の状態と履歴の確認

インストール

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

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

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

同梱ファイル

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

CHANGELOG.md
LICENSE.md
references/
authentication.md

詳細

KuCoin Convert スキル

KuCoin でコンバート通貨、見積もり、注文の詳細を照会します。結果は JSON 形式で返します。

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

クイックリファレンス

エンドポイント説明必須任意認証
/api/v1/convert/symbol (GET)Convert Symbol を取得fromCurrency, toCurrencyorderType不要
/api/v1/convert/currencies (GET)Convert Currencies を取得なしなし不要
/api/v1/convert/quote (GET)Convert Quote を取得fromCurrency, toCurrencyfromCurrencySize, toCurrencySize必要
/api/v1/convert/order/detail (GET)Convert Order Detail を取得orderId または clientOrderId(少なくとも一方)なし必要
/api/v1/convert/order/history (GET)Convert Order History を取得なしstatus, startAt, endAt, page, pageSize必要
/api/v1/convert/limit/quote (GET)Convert Limit Quote を取得fromCurrency, toCurrencyfromCurrencySize, toCurrencySize必要
/api/v1/convert/limit/order/detail (GET)Convert Limit Order Detail を取得なしorderId, clientOrderId必要
/api/v1/convert/limit/orders (GET)Convert Limit Orders を取得なしstatus, startAt, endAt, page, pageSize必要

パラメーター

共通パラメーター
  • fromCurrency: 取引ペアのソース通貨(例: BTC)
  • toCurrency: 取引ペアのターゲット通貨(例: USDT)
  • fromCurrencySize: コンバートするソース通貨の数量。fromCurrencySize または toCurrencySize のいずれかを指定する必要があり、両方を同時に指定することはできません。
  • toCurrencySize: コンバートするターゲット通貨の数量。fromCurrencySize または toCurrencySize のいずれかを指定する必要があり、両方を同時に指定することはできません。
  • orderType: コンバートシンボルを照会する際の注文タイプフィルター(例: MARKET)
  • orderId: コンバート注文 ID。詳細エンドポイントでは、orderId または clientOrderId のいずれかを指定する必要があります。
  • clientOrderId: ユーザーが定義する一意の注文識別子。最大 40 文字です。
  • status: 履歴照会時の注文ステータスフィルター。
  • startAt: 注文の開始時刻フィルター。Unix ミリ秒単位です。
  • endAt: 注文の終了時刻フィルター。Unix ミリ秒単位です。
  • page: ページネーション結果の現在のページ番号。
  • pageSize: 1 ページあたりの結果数(20~100)。
列挙型
  • orderType: MARKET | LIMIT
  • status(成行注文): OPEN | SUCCESS | FAIL
  • status(指値注文): OPEN | SUCCESS | FAIL | CANCELLED

認証

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

  • API Key (KC-API-KEY): KuCoin API キー(ヘッダーとして送信)
  • API Secret: KuCoin API シークレット(HMAC-SHA256 署名に使用)
  • Passphrase (KC-API-PASSPHRASE): KuCoin API パスフレーズ(ヘッダーとして送信。API Secret を使用して HMAC-SHA256 で暗号化)

ベース URL:

セキュリティ

認証情報の共有

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

abc123...apikey
secret123...key
passphrase123
API Key、Secret、Passphrase を開示しない

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

API キー、シークレット、パスフレーズを KuCoin 本番 API 以外のいかなるウェブサイトにも送信しないでください。

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

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

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

認証情報を求められた際の応答例: Account: main API Key: su1Qc...8akf Secret: ***...aws1 Passphrase: ***... Environment: Production

アカウントの一覧表示

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

  • main (Production)
  • trading-bot (Production)
トランザクション

変換トランザクションを実行する際は、必ず事前にユーザーに確認し、続行するには「CONFIRM」と入力するよう求めてください。


KuCoin アカウント

main
  • API Key: your_api_key
  • Secret: your_api_secret

コメント