magic-markets/magic-api

Que fait magic-api ?

Compétence Claude + documentation de référence pour l'API REST et WebSocket de MagicMarkets — passer des ordres, gérer les battements de cœur, diffuser les prix en direct.

Aperçu

Cette compétence permet à Claude d'interagir avec l'API MagicMarkets. Elle comprend des exemples de code, des descriptions d'endpoints et des notes d'utilisation couvrant à la fois les endpoints REST et les flux WebSocket.

Plateformes prises en charge

• Claude Code
• Cursor
• Codex
• Tout agent compatible avec le protocole MCP (Model Context Protocol)

Démarrage rapide

1. Assurez-vous que vos variables d'environnement sont définies :

export MAGIC_API_KEY="votre_clé_api"
export MAGIC_API_SECRET="votre_secret_api"

2. Utilisez la compétence en demandant à Claude d'effectuer des opérations telles que :

• Passe un ordre d'achat de 10 actions MAGIC à 150,50
• Quel est mon solde actuel ?
• Configure un flux WebSocket pour les prix de MAGIC

Endpoints API

REST

Méthode	Endpoint	Description
GET	/api/v1/account	Récupère les détails du compte
POST	/api/v1/orders	Passe un nouvel ordre
DELETE	/api/v1/orders/{id}	Annule un ordre

WebSocket

Événement	Description
heartbeat	Maintenir la connexion active (envoyer toutes les 30 secondes)
price	Diffuse les mises à jour de prix en direct
orderbook	Diffuse les instantanés du carnet d'ordres

Exemples

Passer un ordre REST

import requests

url = "https://api.magicmarkets.com/api/v1/orders"
headers = {
    "X-API-Key": "votre_clé_api",
    "Content-Type": "application/json"
}
data = {
    "symbol": "MAGIC",
    "side": "buy",
    "quantity": 10,
    "price": 150.50
}
response = requests.post(url, json=data, headers=headers)
print(response.json())

Connexion WebSocket

const WebSocket = require('ws');
const ws = new WebSocket('wss://api.magicmarkets.com/ws');

ws.on('open', () => {
  // Envoyer un battement de cœur toutes les 30 secondes
  setInterval(() => {
    ws.send(JSON.stringify({ type: 'heartbeat' }));
  }, 30000);

  // S'abonner aux prix
  ws.send(JSON.stringify({ type: 'subscribe', symbol: 'MAGIC' }));
});

ws.on('message', (data) => {
  console.log('Reçu :', data.toString());
});

Configuration avancée

• Délai d'attente des requêtes : définissez MAGIC_API_TIMEOUT (valeur par défaut : 30 secondes)
• URL de base : définissez MAGIC_API_BASE_URL pour remplacer l'URL par défaut (https://api.magicmarkets.com)

Dépannage

• Erreur 401 : Vérifiez que MAGIC_API_KEY et MAGIC_API_SECRET sont correctement définis.
• Échec de connexion WebSocket : Assurez-vous que le pare-feu autorise les connexions WebSocket sortantes.
• Délai d'attente des ordres : Augmentez MAGIC_API_TIMEOUT si les ordres prennent plus de temps que prévu.

Sécurité

Ne partagez jamais vos clés API ou secrets. Stockez-les dans des variables d'environnement ou utilisez un gestionnaire de secrets.