blofin-setup

BloFin のセットアップ

BloFin 取引所で取引するために、BloFin MCP サーバーのセットアップと設定方法を案内します。

前提条件

• Node.js（v18 以降）と npm がインストールされていること
• blofin.com の BloFin アカウント

セットアップ手順

1. blofin-mcp をインストールする

npm install -g blofin-mcp

または、ローカルにインストールします。

git clone https://github.com/blofin/blofin-mcp.git
cd blofin-mcp
npm install
npm run build

2. BloFin API キーを作成する

ユーザーを BloFin API Management に案内します。

1. BloFin にログインします
2. Account > API Management に移動します
3. Create API Key をクリックします
4. 権限を設定します。
   • READ — 残高、注文履歴、ポジションを表示します
   • TRADE — 注文を発注、キャンセルします
   • TRANSFER — アカウント間で資金を移動します
5. Passphrase を設定します（忘れないようにしてください）
6. （推奨）セキュリティのため、IP ホワイトリストに登録します
7. API Key と Secret Key を保存します。シークレットは一度だけ表示されます

3. MCP サーバーを設定する

エージェントの MCP 設定（例：mcp.json または settings.json）に blofin MCP サーバーを追加します。

{
  "mcpServers": {
    "blofin": {
      "command": "node",
      "args": ["/path/to/blofin-mcp/dist/index.js"],
      "env": {
        "BLOFIN_API_KEY": "your-api-key",
        "BLOFIN_API_SECRET": "your-api-secret",
        "BLOFIN_PASSPHRASE": "your-passphrase",
        "BLOFIN_BROKER_ID": "your-broker-id (optional)",
        "BLOFIN_BASE_URL": "https://openapi.blofin.com"
      }
    }
  }
}

/path/to/blofin-mcp を実際のインストール先（例：npm のグローバルパスまたはローカルのクローンディレクトリ）に置き換えます。

4. ベース URL の設定

環境	ベース URL	用途
デモ取引	https://demo-trading-openapi.blofin.com	テスト、学習、ペーパートレード
本番環境	https://openapi.blofin.com	実資金での取引

• BLOFIN_BASE_URL が設定されていない場合、デフォルトではデモ取引が使用されます
• セットアップが正しく動作することを確認するため、必ずデモ取引から始めてください
• 本番環境への切り替えは、デモでのテストが正常に完了してから行ってください

5. 接続を確認する

設定後、セットアップが正常に動作することを確認します。

1. get_apikey_info を使用して、API キーの権限とステータスを確認します
2. instId: "BTC-USDT" を指定して get_tickers を使用し、公開データにアクセスできることをテストします
3. get_balance を使用して、認証済みアクセスを確認します
4. API キーに想定した権限があることを確認します（readOnly フィールド：0 = 読み取りと書き込み、1 = 読み取り専用）

6. トラブルシューティング

問題	解決策
署名の検証に失敗しました	API シークレットとパスフレーズが正しいことを確認し、余分なスペースがないことを確認します
IP がホワイトリストに登録されていません（152406）	BloFin で、現在の IP を API キーのホワイトリストに追加します
アクセスキーの有効期限が切れています（152402）	IP に紐付けられていないキーは 90 日後に期限切れになります。キーを再作成するか、IP を紐付けてください
レート制限（429）	リクエスト頻度を下げます。REST API の制限は IP あたり 500 回／分です
接続がタイムアウトしました	ネットワークを確認し、ベース URL が正しいことを確認します

環境変数リファレンス

変数	必須	説明
BLOFIN_API_KEY	はい	BloFin API キー
BLOFIN_API_SECRET	はい	BloFin API シークレットキー
BLOFIN_PASSPHRASE	はい	API キーの作成時に設定したパスフレーズ
BLOFIN_BROKER_ID	いいえ	注文の帰属を示すブローカー ID（BloFin から提供されます）
BLOFIN_BASE_URL	いいえ	API ベース URL（デフォルトではデモ取引エンドポイント）

セキュリティのベストプラクティス

• API シークレットとパスフレーズを共有または公開しないでください
• 本番環境では、必ず API キーを特定の IP アドレスに紐付けてください
• 用途に応じて必要最小限の権限を使用してください
• API キーを定期的にローテーションしてください
• まず READ 権限のみで開始し、必要に応じて権限を追加してください