convert

Binance Convert スキル

認証済み API エンドポイントを使用して、Binance で変換リクエストを実行します。一部のエンドポイントでは API キーとシークレットキーが必要です。結果は JSON 形式で返されます。

クイックリファレンス

エンドポイント	説明	必須	任意	認証
/sapi/v1/convert/exchangeInfo (GET)	すべての Convert ペアを一覧表示	なし	fromAsset, toAsset	いいえ
/sapi/v1/convert/assetInfo (GET)	資産ごとの注文数量精度を照会(USER_DATA)	なし	recvWindow	はい
/sapi/v1/convert/acceptQuote (POST)	見積もりを承認(TRADE)	quoteId	recvWindow	はい
/sapi/v1/convert/limit/cancelOrder (POST)	指値注文をキャンセル(USER_DATA)	orderId	recvWindow	はい
/sapi/v1/convert/tradeFlow (GET)	Convert 取引履歴を取得(USER_DATA)	startTime, endTime	limit, recvWindow	はい
/sapi/v1/convert/orderStatus (GET)	注文状況(USER_DATA)	なし	orderId, quoteId	はい
/sapi/v1/convert/limit/placeOrder (POST)	指値注文を発注(USER_DATA)	baseAsset, quoteAsset, limitPrice, side, expiredType	baseAmount, quoteAmount, walletType, recvWindow	はい
/sapi/v1/convert/limit/queryOpenOrders (GET)	指値の未約定注文を照会(USER_DATA)	なし	recvWindow	はい
/sapi/v1/convert/getQuote (POST)	見積もりリクエストを送信(USER_DATA)	fromAsset, toAsset	fromAmount, toAmount, walletType, validTime, recvWindow	はい

---

パラメーター

共通パラメーター

• fromAsset：ユーザーが支払うコイン
• toAsset：ユーザーが受け取るコイン
• recvWindow：値は 60000 以下にしてください（例：5000）
• quoteId：（例：1）
• orderId：placeOrder API の orderId（例：1）
• startTime：（例：1623319461670）
• endTime：（例：1641782889000）
• limit：デフォルトは 100、最大は 1000（例：100）
• orderId：orderId または quoteId のいずれかが必須です（例：1）
• quoteId：orderId または quoteId のいずれかが必須です（例：1）
• baseAsset：ベース資産（どちらが baseAsset かを確認するには、GET /sapi/v1/convert/exchangeInfo API のレスポンス fromIsBase を使用してください）
• quoteAsset：クォート資産
• limitPrice：シンボルの指値価格（baseAsset から quoteAsset への変換）（例：1.0）
• baseAmount：ベース資産の数量。（baseAmount または quoteAmount のいずれかが必須です）（例：1.0）
• quoteAmount：クォート資産の数量。（baseAmount または quoteAmount のいずれかが必須です）（例：1.0）
• side：BUY または SELL（例：BUY）
• walletType：資産を保有するウォレットを選択します。ウォレットは SPOT、FUNDING、EARN から選択できます。SPOT_FUNDING、FUNDING_EARN、SPOT_FUNDING_EARN、SPOT_EARN のように、複数のウォレットを組み合わせることもできます。デフォルトは SPOT です。
• expiredType：1_D、3_D、7_D、30_D（D は日を表します）
• fromAsset：
• toAsset：
• fromAmount：指定すると、変換後に引き落とされる数量になります（例：1.0）
• toAmount：指定すると、変換後に入金される数量になります（例：1.0）
• validTime：10s、30s、1m。デフォルトは 10s です（例：10s）

認証

認証が必要なエンドポイントでは、Binance API の認証情報が必要です。 必要な認証情報：

• apiKey：Binance API キー（ヘッダー用）
• secretKey：Binance API シークレット（署名用）

ベース URL：

• メインネット：https://api.binance.com

セキュリティ

認証情報の共有

ユーザーは、さまざまな方法で Binance API の認証情報を提供できます。エージェントは最初の 2 つの方法を使って認証情報を自動的に取得しますが、認証情報を設定済み、または .env ファイルに保存済みであることをエージェントに明示的に伝えることもできます。その場合、エージェントはそのファイルを再読み込みする必要があります。また、エージェントは最初の 2 つの方法では、ユーザーの確認なしで HTTP リクエストを実行できます。

1. 環境変数

次の特定の変数のみを検索してください（環境変数全体を出力してはいけません）。

使用を許可された環境変数

• Mainnet：BINANCE_API_KEY と BINANCE_SECRET_KEY

生のキーがエージェントのコンテキストに入らないよう、単一の exec 呼び出しで読み取って使用してください。

KEY="$BINANCE_API_KEY"
SECRET="$BINANCE_SECRET_KEY"

response=$(curl -s -X GET "$URL" \
  -H "X-MBX-APIKEY: $KEY" \
  --data-urlencode "param1=value1")

echo "$response"

環境変数は OpenClaw の起動前に設定する必要があります。プロセスの起動時に継承されるため、実行中のインスタンスには注入できません。再起動せずに認証情報を追加または更新する必要がある場合は、シークレットファイルを使用してください（オプション 2 を参照）。

2. シークレットファイル（.env）

~/.openclaw/secrets.env、~/.env、またはワークスペース内の .env ファイルを確認してください。grep で個々のキーを読み取り、ファイル全体を source してはいけません。

# Try all credential locations in order
API_KEY=$(grep '^BINANCE_API_KEY=' ~/.openclaw/secrets.env 2>/dev/null | cut -d= -f2-)
SECRET_KEY=$(grep '^BINANCE_SECRET_KEY=' ~/.openclaw/secrets.env 2>/dev/null | cut -d= -f2-)

# Fallback: search .env in known directories (KEY=VALUE then raw line format)
for dir in ~/.openclaw ~; do
  [ -n "$API_KEY" ] && break
  env_file="$dir/.env"
  [ -f "$env_file" ] || continue

  # Read first two lines
  line1=$(sed -n '1p' "$env_file")
  line2=$(sed -n '2p' "$env_file")

  # Check if lines contain '=' indicating KEY=VALUE format
  if [[ "$line1" == *=* && "$line2" == *=* ]]; then
    API_KEY=$(grep '^BINANCE_API_KEY=' "$env_file" 2>/dev/null | cut -d= -f2-)
    SECRET_KEY=$(grep '^BINANCE_SECRET_KEY=' "$env_file" 2>/dev/null | cut -d= -f2-)
  else
    # Treat lines as raw values
    API_KEY="$line1"
    SECRET_KEY="$line2"
  fi
done

このファイルは OpenClaw を再起動せずにいつでも更新できます。キーは呼び出しごとに最新の内容が読み込まれます。ユーザーが変数を設定済み、または .env ファイルに保存済みだと伝えた場合は、そのファイルを再読み込みしてください。

3. インラインファイル

内容が次の形式のファイルを送信します。

abc123...xyz
secret123...key

• 特定の変数名を指定せずに printenv、env、export、または set を実行してはいけません
• grep で環境変数ファイルを検索する場合は、特定のキー（^VARNAME=）に必ず絞り込んでください
• シークレットファイルをシェル環境に読み込んではいけません（source .env または . .env）
• 現在のタスクで明示的に必要な認証情報のみを読み取ってください
• 生の認証情報を出力や返信に表示または記録してはいけません
• 実際の認証情報が含まれている場合は、TOOLS.md をバージョン管理にコミットしてはいけません。.gitignore に追加してください

API キーとシークレットを絶対に開示しない

API キーとシークレットのファイルの場所を絶対に開示してはいけません。

API キーとシークレットを、Mainnet と Testnet 以外のウェブサイトに絶対に送信してはいけません。

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

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

• API Key： 先頭 5 文字と末尾 4 文字を表示します：su1Qc...8akf
• Secret Key： 必ずマスクし、末尾 5 文字のみを表示します：***...aws1

認証情報を尋ねられた場合の応答例： アカウント：main API Key：su1Qc...8akf Secret：***...aws1

アカウントの一覧表示

アカウントを一覧表示する場合は、名前と環境のみを表示し、キーは絶対に表示してはいけません。 Binance アカウント：

• main（Mainnet）
• futures-keys（Mainnet）

Mainnet でのトランザクション

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

---

Binance アカウント

main

• API Key：your_mainnet_api_key
• Secret：your_mainnet_secret

TOOLS.md の構造

## Binance Accounts

### main
- API Key: abc123...xyz
- Secret: secret123...key
- Description: Primary trading account

### futures-keys
- API Key: futures789...def
- Secret: futuressecret...uvw
- Description: Futures trading account

エージェントの動作

1. 認証情報を求められた場合：シークレットをマスクします（末尾 5 文字のみ表示）
2. アカウントの一覧表示：名前と環境を表示し、キーは絶対に表示しません
3. アカウントの選択：曖昧な場合は確認し、デフォルトで main を使用します
4. Mainnet でトランザクションを実行する場合：続行する前に「CONFIRM」と入力するようユーザーに求め、確認を取ります
5. 新しい認証情報：名前、環境、署名モードを尋ねます

新しいアカウントの追加

ユーザーがインラインファイルまたはメッセージで新しい認証情報を提供した場合：

• アカウント名を尋ねます
• マスクした表示を確認として示し、TOOLS.md に保存します

リクエストの署名

署名が必要な取引エンドポイントの場合：

1. まずキーの種類を検出します。 署名する前にシークレットキーの形式を確認してください。
2. タイムスタンプ（Unix ミリ秒）を含むすべてのパラメーターを使用して、クエリ文字列を作成します。
3. RFC 3986 に従って、パラメーターを UTF-8 でパーセントエンコードします。
4. アカウントの設定に応じて、シークレットキーを使用し、HMAC SHA256、RSA、または Ed25519 でクエリ文字列に署名します。
5. クエリ文字列に署名を追加します。
6. X-MBX-APIKEY ヘッダーを含めます。

それ以外の場合は、手順 4～6 を実行しないでください。

ユーザーエージェントヘッダー

次の文字列を含む User-Agent ヘッダーを指定してください：binance-convert/1.1.0 (Skill)

実装の詳細については、references/authentication.mdを参照してください。