mcpField
A
assets

assets

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

assets について

KuCoin Assets Skill は、KuCoin 利用者向けに現物、マージン、先物、サブアカウントの情報を照会します。認証済みの Classic REST API の GET エンドポイントのみを使い、読み取り専用で JSON を返します。

主な機能

  1. 01口座残高と台帳の照会
  2. 02サブアカウントと残高の確認
  3. 03入出金履歴の照会
  4. 04振替可能額と取引手数料の取得
  5. 05読み取り専用の GET 操作

活用シーン

  1. 01現物、マージン、先物資産の確認
  2. 02サブアカウント残高と API キー情報の確認
  3. 03入出金や台帳履歴の検索

インストール

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

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

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

同梱ファイル

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

CHANGELOG.md
LICENSE.md
references/
authentication.md

詳細

KuCoin Assets Skill

認証済み API エンドポイントを使用した KuCoin での資産管理。すべてのエンドポイントで API Key、API Secret、Passphrase が必要です。結果は JSON 形式で返します。

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

クイックリファレンス

Classic API -- アカウント & ファンディング
エンドポイント説明必須任意認証
GET /api/v2/user-infoアカウント概要情報を取得なしなしはい
GET /api/v1/user/api-keyApikey 情報を取得なしなしはい
GET /api/v1/hf/accounts/openedアカウントタイプを取得 - 現物なしなしはい
GET /api/v1/accountsアカウント一覧を取得 - 現物なしcurrency, typeはい
GET /api/v1/accounts/{accountId}アカウント詳細を取得 - 現物accountId（パス）なしはい
GET /api/v3/margin/accountsアカウントを取得 - クロスマージン。Note: アカウントで証拠金取引が有効になっている必要があります。なしquoteCurrency, queryTypeはい
GET /api/v3/isolated/accountsアカウントを取得 - 分離マージン。Note: アカウントで証拠金取引が有効になっている必要があります。なしsymbol, quoteCurrency, queryTypeはい
GET /api/v1/account-overviewアカウントを取得 - 先物。Note: 先物のベース URL（https://api-futures.kucoin.com）を使用する必要があります。なしcurrencyはい
GET /api/v1/accounts/ledgersアカウント元帳を取得 - 現物/マージンなしcurrency, direction, bizType, startAt, endAt, currentPage, pageSizeはい
GET /api/v1/hf/accounts/ledgersアカウント元帳を取得 - Trade_hfなしcurrency, direction, bizType, lastId, limit, startAt, endAtはい
GET /api/v3/hf/margin/account/ledgersアカウント元帳を取得 - Margin_hfなしcurrency, direction, bizType, lastId, limit, startAt, endAtはい
GET /api/v1/transaction-historyアカウント元帳を取得 - 先物。Note: 先物のベース URL（https://api-futures.kucoin.com）を使用する必要があります。なしcurrency, type, offset, forward, maxCount, startAt, endAtはい
Classic API -- サブアカウント
エンドポイント説明必須任意認証
GET /api/v2/sub/userサブアカウント一覧を取得 - 概要情報なしcurrentPage, pageSizeはい
GET /api/v1/sub-accounts/{subUserId}サブアカウント詳細を取得 - 残高subUserId（パス）includeBaseAmount, baseCurrency, baseAmountはい
GET /api/v2/sub-accountsサブアカウント一覧を取得 - 現物残高（V2）なしcurrentPage, pageSizeはい
GET /api/v1/account-overview-allサブアカウント一覧を取得 - 先物残高（V2）。Note: 先物のベース URL（https://api-futures.kucoin.com）を使用する必要があります。なしcurrencyはい
Classic API -- サブアカウント API
エンドポイント説明必須任意認証
GET /api/v1/sub/api-keyサブアカウント API 一覧を取得subNameapiKeyはい
Classic API -- 入金
エンドポイント説明必須任意認証
GET /api/v3/deposit-addresses入金アドレスを取得（V3）currencychainはい
GET /api/v1/deposits入金履歴を取得currencystatus, startAt, endAt, currentPage, pageSizeはい
Classic API -- 出金
エンドポイント説明必須任意認証
GET /api/v1/withdrawals/quotas出金上限を取得currencychainはい
GET /api/v1/withdrawals/{withdrawalId}ID で出金履歴を取得withdrawalId（パス）なしはい
GET /api/v1/withdrawals出金履歴を取得currencystatus, startAt, endAt, currentPage, pageSizeはい
Classic API -- 送金
エンドポイント説明必須任意認証
GET /api/v1/accounts/transferable送金可能量を取得currency、typetagはい
Classic API -- 取引手数料
エンドポイント説明必須任意認証
GET /api/v1/base-fee基本手数料を取得 - 現物/信用なしcurrencyTypeはい
GET /api/v1/trade-fees実際の手数料を取得 - 現物/信用symbolsなしはい
GET /api/v1/trade-fees実際の手数料を取得 - 先物。注意: 先物のベース URL (https://api-futures.kucoin.com) を使用する必要があります。symbolsなしはい

パラメータ

共通パラメータ
  • currency: 通貨コード (例: BTC、USDT、ETH)。一部のエンドポイントでは、カンマ区切りで複数の通貨を指定して照会できます。
  • chain: 通貨のチェーン ID (例: eth、trx、bsc、ton2、arbitrum)。マルチチェーン通貨の場合に推奨されます。
  • startAt / endAt: Unix エポックからのミリ秒単位の開始時刻と終了時刻。
  • currentPage: 現在のリクエストページ。デフォルトは 1。
  • pageSize: 1 ページあたりの結果数。エンドポイントによって異なります (通常は最小 10、最大 100〜500)。
  • lastId: 前のバッチの最後のデータセットの ID。カーソルベースのページネーションに使用します。
  • direction: 送金の方向: in または out。
Classic API アカウントパラメータ
  • type (現物アカウント一覧): アカウントタイプ: main (資金)、trade (現物)。
  • accountId: アカウント ID (アカウント詳細のパスパラメータ)。
  • quoteCurrency: 信用アカウントのクォート通貨: USDT、KCS、BTC。
  • queryType (クロスマージン): MARGIN、MARGIN_V2、ALL。
  • queryType (分離マージン): ISOLATED、ISOLATED_V2、ALL。
  • bizType (現物/信用元帳): DEPOSIT、WITHDRAW、TRANSFER、SUB_TRANSFER、TRADE_EXCHANGE、MARGIN_EXCHANGE、KUCOIN_BONUS、BROKER_TRANSFER。
  • bizType (Trade_hf 元帳): TRADE_EXCHANGE、TRANSFER、SUB_TRANSFER、RETURNED_FEES、DEDUCTION_FEES、OTHER。
  • bizType (Margin_hf 元帳): TRANSFER、MARGIN_EXCHANGE、ISOLATED_EXCHANGE、LIQUIDATION、ASSERT_RETURN。
  • type (先物元帳): RealisedPNL、Deposit、Withdrawal、TransferIn、TransferOut。
  • offset: 先物元帳のページネーションの開始オフセット。
  • forward: ブール値。true で前方検索 (デフォルト)、false で後方検索。
  • maxCount: 先物元帳の 1 ページあたりの表示件数。デフォルトは 50。
  • limit: HF 元帳照会の 1 ページあたりの結果数。
サブアカウントパラメータ
  • subUserId: サブアカウントのユーザー ID (パスパラメータ)。
  • subName: サブアカウント名 (API キー照会用)。
  • apiKey: サブアカウントの API キー (フィルタパラメータ)。
  • includeBaseAmount: ブール値。true で残高ゼロの通貨を含むすべての通貨を表示します。
  • baseCurrency: 資産価値の換算と表示に使用する通貨。
  • baseAmount: フィルタ: 通貨残高がこの額以上である必要があります。
入金・出金パラメータ
  • status (入金履歴): PROCESSING、SUCCESS、FAILURE、WAIT_TRM_MGT、TRM_MGT_REJECTED。
  • status (出金履歴): PROCESSING、REVIEW、WALLET_PROCESSING、SUCCESS、FAILURE。
  • withdrawalId: 出金 ID (パスパラメータ)。
送金パラメータ
  • type (送金可能量): アカウントタイプ: MAIN、TRADE、MARGIN、ISOLATED、MARGIN_V2、ISOLATED_V2。
  • tag: アカウントタイプが ISOLATED の場合に必要な取引ペア (例: BTC-USDT)。
取引手数料パラメータ
  • currencyType: 通貨タイプ: 0 (暗号通貨)、1 (法定通貨)。デフォルトは 0。
  • symbols: 手数料照会の取引ペアシンボル。現物/信用の場合: 例 BTC-USDT,ETH-USDT (最大 10)。先物の場合: 例 XBTUSDTM (先物のベース URL を使用する必要があります)。

列挙型

アカウント種別（クラシック API）
値説明
main資金調達アカウント
tradeスポット取引アカウント
MAIN資金調達アカウント（送金コンテキスト）
TRADEスポット取引アカウント（送金コンテキスト）
CONTRACT先物アカウント（送金コンテキスト）
MARGINクロスマージンアカウント（HF）
ISOLATED分離マージンアカウント（HF）
MARGIN_V2クロスマージンアカウント（レガシー、段階的廃止）
ISOLATED_V2分離マージンアカウント（レガシー、段階的廃止）
入金ステータス
値説明
PROCESSING入金を処理中です
SUCCESS入金が正常に完了しました
FAILURE入金に失敗しました
WAIT_TRM_MGTトラベルルール管理を待機中です
TRM_MGT_REJECTEDトラベルルール管理により拒否されました
出金ステータス
値説明
REVIEW審査中です
PROCESSING処理中です
WALLET_PROCESSINGウォレットを処理中です
SUCCESS出金が正常に完了しました
FAILURE出金に失敗しました

認証

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

必要な認証情報：

  • API Key：お客様の KuCoin API キー（KC-API-KEY ヘッダーとして送信されます）
  • API Secret：お客様の KuCoin API シークレット（HMAC-SHA256 署名に使用されます）
  • Passphrase：API キー作成時に設定したパスフレーズ（KC-API-PASSPHRASE ヘッダーとして送信され、API Key Version 2 では暗号化されます）

ベース URL：

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

セキュリティ

認証情報の共有

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

your-api-key
your-api-secret
your-passphrase
API キー、シークレット、パスフレーズを決して開示しない

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

本番環境の KuCoin API 以外の Web サイトに API キー、シークレット、パスフレーズを決して送信しないでください。

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

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

  • API Key： 最初の 5 文字 + 最後の 4 文字を表示します：68d4a...841d
  • Secret Key： 常にマスクし、最後の 5 文字のみを表示します：***...b2340
  • Passphrase： 常に全体をマスクします：***...

認証情報を求められた場合の応答例： Account: main API Key: 68d4a...841d Secret: ***...b2340 Passphrase: ***... Environment: Production

アカウントの一覧表示

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

  • main (Production)
  • sub-keys (Production)
トランザクション

データを変更する操作（送金、出金、サブアカウントの作成）を実行する場合は、必ずユーザーに「CONFIRM」と入力して続行するよう求めることで、続行前に確認を取ってください。

KuCoin アカウント

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

コメント

Markdown 対応