spot

KuCoin 現物スキル

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

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

クイックリファレンス

Classic API - 現物市場データ

エンドポイント	説明	必須	任意	認証
/api/v3/announcements (GET)	お知らせを取得	なし	currentPage, pageSize, annType, lang, startTime, endTime	不要
/api/v3/currencies/{currency} (GET)	通貨の詳細を取得	currency (パス)	chain	不要
/api/v3/currencies (GET)	すべての通貨を取得	なし	なし	不要
/api/v2/symbols/{symbol} (GET)	シンボルの詳細を取得	symbol (パス)	なし	不要
/api/v2/symbols (GET)	すべてのシンボルを取得	なし	market	不要
/api/v1/market/orderbook/level1 (GET)	ティッカー（最良買値/売値）を取得	symbol	なし	不要
/api/v1/market/allTickers (GET)	すべてのティッカーを取得	なし	なし	不要
/api/v1/market/histories (GET)	取引履歴を取得	symbol	なし	不要
/api/v1/market/candles (GET)	ローソク足を取得	symbol, type	startAt (秒), endAt (秒)	不要
/api/v1/market/orderbook/level2_{size} (GET)	板情報の一部を取得	size (パス: 20, 100), symbol	なし	不要
/api/v3/market/orderbook/level2 (GET)	板情報全体を取得	symbol	なし	必要
/api/v1/market/orderbook/callauction/level2_{size} (GET)	呼値競争の板情報の一部を取得	size (パス: 20, 100), symbol	なし	不要
/api/v1/market/callauctionData (GET)	呼値競争の情報を取得	symbol	なし	不要
/api/v1/prices (GET)	法定通貨価格を取得	なし	base, currencies	不要
/api/v1/market/stats (GET)	24時間統計を取得	symbol	なし	不要
/api/v1/markets (GET)	市場リストを取得	なし	なし	不要

Classic API - 現物 HF 注文クエリ

エンドポイント	説明	必須	任意	認証
/api/v1/hf/orders/{orderId} (GET)	orderId で注文を取得	orderId (パス), symbol	なし	必要
/api/v1/hf/orders/client-order/{clientOid} (GET)	clientOid で注文を取得	clientOid (パス), symbol	なし	必要
/api/v1/hf/orders/active/symbols (GET)	未約定注文があるシンボルを取得	なし	なし	必要
/api/v1/hf/orders/active (GET)	未約定注文を取得	symbol	なし	必要
/api/v1/hf/orders/active/page (GET)	未約定注文を取得（ページネーション）	symbol	pageNum, pageSize	必要
/api/v1/hf/orders/done (GET)	約定済み注文を取得	symbol	side, type, lastId, limit, startAt, endAt	必要
/api/v1/hf/fills (GET)	取引履歴を取得	symbol	orderId, side, type, lastId, limit, startAt, endAt	必要
/api/v1/hf/orders/dead-cancel-all/query (GET)	DCP 設定を取得	なし	なし	必要

Classic API - ストップ注文クエリ

エンドポイント	説明	必須	任意	認証
/api/v1/stop-order (GET)	ストップ注文リストを取得	なし	symbol, side, type, tradeType, startAt, endAt, currentPage, orderIds, pageSize, stop	必要
/api/v1/stop-order/{orderId} (GET)	orderId でストップ注文を取得	orderId (パス)	なし	必要
/api/v1/stop-order/queryOrderByClientOid (GET)	clientOid でストップ注文を取得	clientOid	symbol	必要

Classic API - OCO 注文クエリ

エンドポイント	説明	必須	任意	認証
/api/v3/oco/order/{orderId} (GET)	orderId で OCO 注文を取得	orderId (path)	なし	はい
/api/v3/oco/client-order/{clientOid} (GET)	clientOid で OCO 注文を取得	clientOid (path)	なし	はい
/api/v3/oco/orders (GET)	OCO 注文リストを取得	なし	symbol, startAt, endAt, orderIds, pageSize, currentPage	はい
/api/v3/oco/order/details/{orderId} (GET)	orderId で OCO 注文の詳細を取得	orderId (path)	なし	はい

---

パラメーター

共通パラメーター

• symbol: 取引ペア (例: BTC-USDT)
• currency: 通貨コード (例: BTC, ETH, USDT)
• orderId: 取引システムによって生成された一意の注文 ID
• clientOid: クライアント注文 ID、ユーザーが作成する一意の識別子 (最大 40 文字)
• side: 取引方向フィルター: buy | sell
• type: 注文タイプフィルター: limit | market
• startAt: 開始時間。注意: /api/v1/market/candles の場合は 秒 (10 桁の Unix タイムスタンプ) を使用します。その他のエンドポイントの場合は ミリ秒 (13 桁のタイムスタンプ) を使用します。
• endAt: 終了時間。注意: /api/v1/market/candles の場合は 秒 (10 桁の Unix タイムスタンプ) を使用します。その他のエンドポイントの場合は ミリ秒 (13 桁のタイムスタンプ) を使用します。
• pageSize: 1 ページあたりの項目数 (例: 20, 50, 100)
• currentPage: Classic ページネーションの現在のページ番号
• lastId: カーソルベースのページネーションにおける前回バッチの最後のレコードの ID
• limit: 1 ページあたりの結果数。デフォルト: 20、最大: 100
• stop: ストップ注文トリガー条件フィルター: loss | entry
• tradeType: ストップ注文の取引タイプフィルター
• market: Classic シンボルの取引市場フィルター (例: USDS, BTC, ALTS)
• chain: 通貨クエリ用のブロックチェーンネットワーク (例: ERC20, TRC20)
• base: 価格変換用の基軸法定通貨 (例: USD, EUR)。デフォルト: USD
• currencies: 法定通貨価格用のカンマ区切り暗号通貨リスト (例: BTC,ETH)
• annType: お知らせタイプ (例: latest-announcements, new-listings, activities)
• lang: お知らせの言語 (例: en_US, zh_HK, ja_JP)

列挙型

• side: buy | sell
• type: limit | market
• stop: loss | entry
• kline type: 1min | 3min | 5min | 15min | 30min | 1hour | 2hour | 4hour | 6hour | 8hour | 12hour | 1day | 1week | 1month
• annType: latest-announcements | activities | product-updates | vip | maintenance-updates | delistings | others | api-campaigns | new-listings | futures-announcements

認証

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

• apiKey: KuCoin API キー
• secretKey: KuCoin API シークレット (署名用)
• passphrase: KuCoin API パスフレーズ (これも HMAC 署名されます)

ベース URL:

• Mainnet: https://api.kucoin.com

セキュリティ

認証情報の共有

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

abc123...xyz
secret123...key
passphrase123...abc

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

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

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

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

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

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

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

アカウントの一覧表示

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

• main (Mainnet)
• trading-bot (Mainnet)

Mainnet でのトランザクション

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