convert について
KuCoin の通貨変換ペア、見積もり、注文詳細を照会する Claude Skill です。読み取り専用の Classic REST GET エンドポイントを使い、結果を JSON で返します。
主な機能
- 01対応する変換ペアと通貨の照会
- 02成行・指値の見積もり取得
- 03変換注文の詳細確認
- 04成行・指値注文履歴の一覧
活用シーン
- 01変換前の対応通貨の確認
- 02通貨ペアの見積もり確認
- 03変換注文の状態と履歴の確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ kucoin/ kucoin-skills-hub --skill convertインストール後、Claude Code で/convertを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
CHANGELOG.mdLICENSE.mdreferences/authentication.md詳細
KuCoin Convert スキル
KuCoin でコンバート通貨、見積もり、注文の詳細を照会します。結果は JSON 形式で返します。
Note: このスキルは Classic REST API の GET エンドポイント(読み取り専用操作)のみをサポートします。
クイックリファレンス
| エンドポイント | 説明 | 必須 | 任意 | 認証 |
|---|---|---|---|---|
/api/v1/convert/symbol (GET) | Convert Symbol を取得 | fromCurrency, toCurrency | orderType | 不要 |
/api/v1/convert/currencies (GET) | Convert Currencies を取得 | なし | なし | 不要 |
/api/v1/convert/quote (GET) | Convert Quote を取得 | fromCurrency, toCurrency | fromCurrencySize, 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, toCurrency | fromCurrencySize, 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:
- 本番環境: https://api.kucoin.com
セキュリティ
認証情報の共有
ユーザーは、次の形式の内容を含むファイルを送信することで、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