magic-api は何をしますか？
MagicMarkets REST & WebSocket API 向けのClaudeスキル + リファレンスドキュメント — 注文発注、ハートビート管理、リアルタイム価格ストリーミングに対応。
使用方法
このスキルは、MagicMarkets の API と対話するためのリファレンスを提供します。以下はその一例です。
- REST API: 注文の発注、市場データの取得、アカウント情報の更新など。
- WebSocket API: リアルタイム価格の購読、ハートビートの管理。
認証
すべての API リクエストには、Authorization ヘッダーに API キーを含める必要があります。
Authorization: Bearer YOUR_API_KEY
エンドポイント
| メソッド | エンドポイント | 説明 |
|---|---|---|
| GET | /v1/markets | 利用可能な市場を取得 |
| POST | /v1/orders | 新規注文を発注 |
| DELETE | /v1/orders/{id} | 注文をキャンセル |
WebSocket 接続
以下のように WebSocket に接続します。
const ws = new WebSocket('wss://api.magicmarkets.com/v1/ws');
ws.onopen = () => {
ws.send(JSON.stringify({ type: 'subscribe', channel: 'ticker', symbol: 'BTC/USD' }));
};
ハートビートは 30 秒ごとに送信する必要があります。
setInterval(() => {
ws.send(JSON.stringify({ type: 'ping' }));
}, 30000);